home *** CD-ROM | disk | FTP | other *** search
/ The Business Master (3rd Edition) / The Business Master (3rd Edition).iso / files / utilenus / dm25128 / dm.doc < prev   
Text File  |  1988-08-02  |  118KB  |  2,678 lines
  1.  
  2.  
  3.         DM Users Manual                                          Page 1
  4.         ________________________________________________________________
  5.  
  6.  
  7.  
  8.                          INTRODUCING DIRECTORY MASTER
  9.  
  10.              Directory Master (DM), is a powerful utility program for 
  11.         MS-DOS  compatible  computers.  DM was created to  allow  you  to 
  12.         copy,  move  and delete files quickly and easily. But  we  didn't 
  13.         stop there.  Special features allow you to run programs,  execute 
  14.         commands,  and  view files directly from DM, then  return  to  DM 
  15.         exactly  where you left off.  And DM is streamlined - many  tasks 
  16.         can  be  completed  with just one keystroke.  DM  allows  you  to 
  17.         maintain  order on your disks with a minimum of time and  effort.  
  18.         When you use DM, you are able to skim through your directory  and 
  19.         mark all the files you want to be moved, copied, or deleted.   If 
  20.         you  have  lots of files to delete, you can delete  them  all  at 
  21.         once.   If you  want to copy selected files onto a diskette,  you 
  22.         can copy them all at once.  
  23.  
  24.              If  you have a hard disk, the tree mode allows you  to  jump 
  25.         from the root directory to any subdirectory and back again with a 
  26.         minimum  of keystrokes.  Suppose you want to separate  your  data 
  27.         base  files from your spreadsheet worksheet files.  You can  mark 
  28.         all those data files and move them there all at once.
  29.  
  30.              Perhaps  you have a lot of old document files in  your  word 
  31.         processor program and you want to delete some of the clutter. But 
  32.         you  can't  remember what's in a certain file.  No  problem,  the 
  33.         programmable  function  keys  allow  you  to  call  up  the  word 
  34.         processor  and  load the indicated file in one  keystroke.  After 
  35.         you've  looked over the file and exited the word  processor,  you 
  36.         automatically return to DM, right where you left off.
  37.  
  38.         Here are a few of DM's highlights.
  39.  
  40.                          DM's WORKHORSE FUNCTIONS
  41.  
  42.         *Quick backups - copy all or selected files from one diskette to 
  43.          another, or from the hard drive to diskette or vice versa.  
  44.  
  45.         *Maintain order - categorize your files in subdirectories. DM 
  46.          quickly  moves  your files from one subdirectory to another or 
  47.          from the root directory to subdirectories.
  48.  
  49.         *Easy  disk  cleanup  - move or delete selected  files  from  any 
  50.          drive.
  51.  
  52.                       DM STREAMLINES MAINTENANCE TASKS
  53.  
  54.         *Scan   quickly  through  a  hard  disk's  root   directory   and  
  55.          subdirectories.    
  56.  
  57.         *Check  any  drive to see the size of individual  files  and  the  
  58.          amount of free space on the disk.
  59.  
  60.  
  61.         DM Users Manual                                          Page 2
  62.         ________________________________________________________________
  63.  
  64.  
  65.         *Sort directories for viewing in any order desired:  alphabetical   
  66.          by  filename,  alphabetical by extension, by date,  by  size,  or    
  67.          reverse order.
  68.  
  69.         *List only certain files within a directory, such as those with a  
  70.          given extension.
  71.  
  72.         *Execute a program or view the contents of a file directly from 
  73.          DM, and return to DM exactly where you left off.
  74.  
  75.                          DM's POWERFUL UTILITY FEATURES
  76.  
  77.         *Rename any file.  Change the date on any file.
  78.  
  79.         *Change  the  attributes of a file,  including:  Hidden,  System,   
  80.          Read-Only, and Archive.
  81.  
  82.         *Execute  a DOS command directly from DM and return to DM in  the   
  83.          same place that you left off. 
  84.  
  85.         *Custom program up to 30 function keys.
  86.  
  87.                        THE SOFTWARE PHILOSOPHY BEHIND DM
  88.  
  89.            DM  was  originally  written  in  1985  to  provide  the  same 
  90.         functions for MS-DOS as a program called SWEEP did for CP/M.  The 
  91.         main function of this program is to be able to select files  from 
  92.         a  list  of files, then either copy them, move  them,  or  delete 
  93.         them.  Thus  the  design of this program is such  to  make  these 
  94.         functions as easy as possible.
  95.  
  96.            In  order  to help you decide which files to  copy,  move,  or 
  97.         delete,  DM allows you to sort the list by name, date,  extension 
  98.         or  size, and allows you to select in reverse order. This  allows 
  99.         you to see the directory several different ways. In addition,  DM 
  100.         allows  you  to use a file mask. This allows you to work  with  a 
  101.         smaller group of files rather than the whole directory.
  102.  
  103.            The  files are displayed in a vertical list. The up  and  down 
  104.         arrows,  page up, page down, home and end keys move  you  through 
  105.         the  list.  A GOTO key is provided to help you get to  a  desired 
  106.         place in the list quickly. Files are selected (Marked) using  the 
  107.         right  arrow key, and unselected (UnMarked) using the left  arrow 
  108.         key. All files can be marked using Ctrl-Right-Arrow and  unmarked 
  109.         using  the Ctrl-Left-Arrow. A wild card mark is provided to  mark 
  110.         all files that match a particular mask.
  111.  
  112.            Once  files are marked they can be copied or moved to  another 
  113.         disk drive or subdirectory, or deleted. You can also change  file 
  114.         attributes  on  all marked files or run a program on  all  marked 
  115.         files. Copy, move, delete, and change file attributes can also be 
  116.         performed  on the file the pointer is pointing to. You  can  also 
  117.         rename  the file or change the file's date. You can also run  the 
  118.         file or run up to 30 predefined programs on the file.
  119.  
  120.  
  121.         DM Users Manual                                          Page 3
  122.         ________________________________________________________________
  123.  
  124.  
  125.  
  126.            To  help  you move through the directory structure,  the  Tree 
  127.         Mode is provided. Tree Mode shows you only directories. By  using 
  128.         the arrow keys, you can move all around the directory tree.  When 
  129.         you get to the directory you want, switch back to the File Mode.
  130.  
  131.            DM provides a status window that allows you to see the  number 
  132.         of  files,  the  total size of all files, the  number  of  marked 
  133.         files, and the total size of all marked files. It shows the  free 
  134.         space  on the disk and provides additional information about  the 
  135.         file that you are pointing to. Current path, drive, and file mask 
  136.         information are also displayed.
  137.  
  138.            DM also provides the ability to execute predefined programs on 
  139.         either  the  file you are pointing to, or all  marked  files.  DM 
  140.         creates DOS command lines for you, including the name of the  file 
  141.         you are pointing to, and executes these commands. DM even has the 
  142.         ability  to  figure out what program to run on the file  you  are 
  143.         pointing to by its extension. That's what the Autorun feature is. 
  144.         This  would be used if, for example, you are in your  spreadsheet 
  145.         directory trying to determine what spreadsheets to get rid of. In 
  146.         the process you would like to look at them while you are  marking 
  147.         them  to  refresh  your memory as to what they  contain.  If  you 
  148.         program the AutoRun strings, DM will let you run your spreadsheet 
  149.         program  on  the  file you are pointing  to.  After  viewing  the 
  150.         spreadsheet you return back to DM exactly where you left off.
  151.  
  152.            DM  is  designed to be as intuitive as possible.  If  you  get 
  153.         confused,  press F1 for help. For the basic functions, C  is  for 
  154.         Copy,  D is for Delete, M is for Move, and A is  for  Attributes. 
  155.         These  commands  work on the file that you are pointing  to.  For 
  156.         marked  files  you use Alt-C, Alt-D, Alt-M, and Alt-A. R  is  for 
  157.         Rename, T is for Change Date, F is for Freespace, V is for  View, 
  158.         E is for Edit, P is for Patch, G is for Goto, S is for Sort,  and 
  159.         Q is for Quit.
  160.  
  161.            Many  of  the functions of DM are for  the  advanced  computer 
  162.         user. If you don't understand all the functions of DM, just stick 
  163.         to  the  simple ones. As your knowledge of MS-DOS  and  computers 
  164.         grow, you will find more and more uses for DM.
  165.  
  166.  
  167.  
  168.         DM Users Manual                                          Page 4
  169.         ________________________________________________________________
  170.  
  171.  
  172.  
  173.                     DIRECTORY MASTER SCREEN REFERENCE 
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.         This  is the DM opening screen.  Below is a brief description  of 
  205.         each feature on the screen, followed by a text reference.  
  206.  
  207.         File Window (left window):
  208.  
  209.         File Name - The column of names under this heading is a list of
  210.         the files in the current directory. 
  211.  
  212.         Date - This shows the date that the file was last modified (if
  213.         the system used to make the modification had a clock-calendar).
  214.  
  215.         Size - This tells how many bytes are in the file, in k (1024
  216.         bytes).  
  217.  
  218.         Status Window (Upper Right Window):
  219.  
  220.         Size of Files -  The total disk space used by all of the selected 
  221.         files and all Marked files.
  222.  
  223.  
  224.         DM Users Manual                                          Page 5
  225.         ________________________________________________________________
  226.  
  227.  
  228.         Number of Files - This tells how many files are on the current 
  229.         disk or subdirectory and the number of Marked files.
  230.  
  231.         Free - The amount of free space on the current disk, in k, is 
  232.         shown here.
  233.  
  234.         Sort - The sorted order in which the directory is displayed is
  235.         shown  here.  If "Name" appears here, the directory is  displayed 
  236.         sorted  by  filename in alphabetical order.   (See  "Sorting  the 
  237.         Directory," page 19.)
  238.  
  239.         Subs - This is the number of subdirectories off the current 
  240.         subdirectory. If you enter the Tree Mode, the number of files in the 
  241.         current subdirectory is displayed.
  242.  
  243.         Path  -  This  shows  the  drive  and  pathname  of  the  current 
  244.         directory.  "\" indicates the root directory [Example: Path:C\:], 
  245.         and  a  name after the backslash indicates a  named  subdirectory 
  246.         [Example:   Path:   C:\WS].    (See   "About   Directories    and 
  247.         Subdirectories," pages 12-15.)
  248.  
  249.         Size - This is the actual number of bytes in the file next to the
  250.         pointer.  
  251.  
  252.         Attributes - If the file indicated by the pointer has any special
  253.         attributes, those attributes will be shown here.  (See  "Changing 
  254.         Attributes," page 33.)
  255.  
  256.         Help Screen #1:
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.         DM Users Manual                                          Page 6
  281.         ________________________________________________________________
  282.  
  283.  
  284.         Mask   -  This  tells  which  portion  (selected   filenames   or 
  285.         extensions) in the directory will be listed.  If *.* appears as
  286.         the mask, the entire directory will be shown.  (See "Changing the 
  287.         Mask," page 22.)
  288.  
  289.         F1 Help - displays the next help screen each time F1 is pressed.
  290.  
  291.         Tab - displays the Programmable Function Keys Settings.
  292.  
  293.         Marking and Unmarking Files
  294.  
  295.         Use the following right and left cursor keypad arrows to mark and 
  296.         unmark files:
  297.  
  298.            ->  Marks File            CTRL ->  Marks All Files
  299.            <-  Unmarks File          CTRL <-  Unmarks All Files
  300.  
  301.         The  following  is  a  list of DM  Commands.  (See  "Copying  and 
  302.         Deleting," pages 17-19.)
  303.  
  304.         C  -  Copy  File  - copies only the file  at  the  pointer.  (See 
  305.         "Copying a File," pages 17-18.)
  306.  
  307.         D  -  Delete  File - deletes only the file at  the  pointer  (See 
  308.         "Delete a File," page 18.)
  309.  
  310.         M - Move File - moves only the file at the pointer. (See "Moving
  311.         Files," page 19.)
  312.  
  313.         V - View File - displays the contents of the file at the pointer,
  314.         in ASCII text. (See "View a Data File," page 20.)
  315.  
  316.         E  - Edit File - Setup DM to run your favorite editor  to  modify 
  317.         any text or document file (See "Edit a Data File," page 20.)
  318.  
  319.         E  - Patch File - Setup DM to run your favorite patch program  to 
  320.         modify any file (See "Patch a File," page 20.)
  321.  
  322.         G - Goto FileName - user may search directory for specific file 
  323.         by typing the filename.  (See "Goto Filename," page 22.)
  324.  
  325.         R - Rename File - user may type in new filenames. (See  "Renaming 
  326.         Files," page 19.)
  327.  
  328.         L - Re-read Directory - rereads the current drive. Useful for
  329.         quickly  rereading a new disk when it is inserted in  the  floppy 
  330.         drive,  or to reread current subdirectory after creation  of  new 
  331.         files. (See "Inserting a New Disk," page 22.)
  332.  
  333.         S - Change Sort Order - changes the order in which the directory
  334.         is sorted. (See "Sorting the Directory," page 19.)
  335.  
  336.  
  337.         DM Users Manual                                          Page 7
  338.         ________________________________________________________________
  339.  
  340.  
  341.         A - Change Attributes - changes attributes of the file at the
  342.         pointer.  (See "About Attributes," pages 32-33.)
  343.  
  344.         T - Change Date - user may type in a new date for files. (See 
  345.         "Changing Dates," page 20.)
  346.  
  347.         W - Wildcard Mark - user selects and simultaneously marks several
  348.         files at once by using wildcards. (See "Wildcard Mark," page 24.)
  349.  
  350.         F - FreeSpace - gives statistics for any drive specified. (See
  351.         "Determining Free Space on a Disk," page 22.)
  352.  
  353.         For All Marked Files
  354.  
  355.         Alt-C - Copy Files - copies marked (highlighted) files to the
  356.         specified path. (See "Copy Many Files at Once," page 18.)
  357.  
  358.         Alt-D - Delete Files - deletes all marked (highlighted) files.
  359.         (See "Delete Many Files at Once," page 18.)
  360.  
  361.         Alt-M - Move Files - moves all marked (highlighted) files to the 
  362.         specified path  (See "Moving Files," page 19.)
  363.  
  364.         Alt-A - Change Attributes - changes the attributes of all marked 
  365.         files. (See "Changing Attributes," and "Warning:" page 
  366.         33.)
  367.  
  368.         X - Extra Functions     
  369.  
  370.           R  Reverse all Marks - (See "Reversing Marks," page 24.)
  371.           C  Set Colors - (See "Changing Colors on the Screen," page 24.)
  372.           T  Root Dir Tree Mode - (Quickly display all subdirectories
  373.              off the root directory.)
  374.           \  Root Dir - (Move to the root directory of current drive.)
  375.           S  Save Configuration - save changes made to the screen colors 
  376.              or the Function Key commands.  (See "Changing Colors on the       
  377.              Screen," page 24 and "Saving Your Programming," page 29.)
  378.           V  Set VIEW Prog - (Set up DM to run your favorite view 
  379.              program.)
  380.           E  Set EDIT Prog - (Set up DM to run your favorite editor      
  381.              program.)
  382.           P  Set PATCH Prog - (Set up DM to run your favorite patch         
  383.              program.)
  384.  
  385.         ESC - Escape - used to abort commands or type ESC twice to exit DM.
  386.  
  387.         Q - Quit DM - used to exit the DM program.
  388.  
  389.  
  390.         DM Users Manual                                          Page 8
  391.         ________________________________________________________________
  392.  
  393.  
  394.         DM FUNCTION KEYS
  395.  
  396.         F1 Help Screen No. 1 - Press F1 once to display a full screen  of 
  397.         help.
  398.  
  399.         F1  Help Screen No. 2 - Press F1 again for an introduction to  DM 
  400.         and  help  with  the  Programmable  Function  Keys  and   Autorun 
  401.         Key.  The Alternate Functions Keys are (Alt F1 through Alt  F10), 
  402.         the Control Function Keys are (Ctrl F1 through Ctrl F10) and  the 
  403.         Shift  Function Keys are (Shft F1 through Shft F10).   These  are 
  404.         user defined, you must program these keys and write the help text 
  405.         yourself.   Press the Tab key to view the  Programmable  Function 
  406.         Key Settings. The Autorun Key is F2 and is also programmed.  (See 
  407.         "The Programmable Function Keys," pages 26-30 and  "The  Autorun 
  408.         Key," page 30.) 
  409.  
  410.         F2  AutoRun - this key must also be programmed by the user.   Set 
  411.         it up to execute an application program or a DOS command on files 
  412.         with the same extension.  (See "The AutoRun Key," page 30.) 
  413.  
  414.         F3 Execute File - executes the file at the pointer if the file is
  415.         executable (has extension .EXE, .COM, or .BAT).  (See "Executing a 
  416.         File," page 25.)
  417.  
  418.         F4  DOS  Command - executes a DOS command.  (See "Execute  a  DOS 
  419.         Command," page 25.)
  420.  
  421.         F5 Change Disk - move from one drive to another.  (See  "Changing 
  422.         Disk Drives," page 22.)
  423.  
  424.         F6 Change Path - move to another drive or path or select files by
  425.         using a particular mask with embedded wildcards.  (See "Paths and
  426.         Pathnames," page 13, and "Changing the Mask," page 22.)
  427.  
  428.         F7 Tree Mode - allows scanning of subdirectories.
  429.  
  430.           F7   Toggle this key to enter and exit Tree Mode                   
  431.           R    Rename subdirectory
  432.           ->   Jump to SubDir - move to the subdirectory at pointer
  433.           <-   Jump to SubDir toward Root 
  434.           RET  Jump to SubDir and Exit Tree Mode - lists files in the
  435.                subdirectory indicated by the pointer and exit Tree Mode                                    
  436.           \    Jump  to  Root  Directory -  (See  "About  Directories  and
  437.                Subdirectories," pages 12-15, and "Tree Mode," page 23.)
  438.  
  439.         F8 Edit Commands - used to custom program the Alternate Function
  440.         Keys, Control Function Keys, Shift Function Keys and the  AutoRun 
  441.         Key.  (See "The Programmable Function Keys," pages 26-30, and "The 
  442.         AutoRun Key," page 30.)            
  443.                                                                           
  444.         F9 Print Order Form - used to print DM purchase order form.
  445.  
  446.  
  447.         DM Users Manual                                          Page 9
  448.         ________________________________________________________________
  449.  
  450.  
  451.         F10  Marked  Menu  -  This is an  alternate  method  of  copying, 
  452.         deleting,  moving,  changing  the attributes  and  executing  dos 
  453.         commands on marked (highlighted) files. Use your creativity here.              
  454.  
  455.           C Copy - Copy marked files                               
  456.           D Delete - Delete marked files                       
  457.           M Move - Move marked files                           
  458.           A Change Attributes - Change marked files' attributes
  459.           Ctrl,  Alt & Shift Function Keys or F4 to Batch Execute
  460.           Marked Files
  461.  
  462.         FOR NEW USERS: BASIC MS-DOS FUNCTIONS USED BY DM
  463.          
  464.         This  section is for the novice and provides an  introduction  to 
  465.         MS-DOS  functions  and  commands  that  relate  directly  to  DM.  
  466.         If  you are familiar with DOS you may wish to skip  this  section 
  467.         and  go  directly  to page 16 "Using DM".   Consult  your  MS-DOS 
  468.         manual  for more in-depth explanations of DOS functions,  or  any 
  469.         commands  not covered here.  Throughout this manual, you will  be 
  470.         asked  to  press the "Enter" key.  On some keyboards, it  may  be 
  471.         called the "Return" key, and on others it is simply marked with a 
  472.         "<--+."   Regardless of how it is labeled, you want to press  the 
  473.         key that gives you a carriage return.
  474.  
  475.         Booting the System
  476.  
  477.         Dual Floppy Systems:  Insert your DOS disk in drive A and turn on 
  478.         the  system.  When the computer is ready to go, the message  "A:" 
  479.         will  appear.  This is called the "prompt" and it means that  the 
  480.         computer is ready to accept commands.
  481.  
  482.         You have two disk drives.  The one on top is Drive A.  The bottom 
  483.         one is Drive B.  Drive A is the "default drive" which means  that 
  484.         when you enter a command or filename, the computer  automatically 
  485.         searches the disk in drive A unless you specify another drive.  
  486.  
  487.         Hard  Disk Systems: Turn on the computer.  When the  "C:"  prompt 
  488.         appears, the computer is ready to accept commands. The hard  disk 
  489.         is  called  drive C, and the drive for floppy disks is  Drive  A.  
  490.         Drive C is the default drive.  
  491.  
  492.         Rebooting
  493.  
  494.         If  you get stuck and want to start over, you can "reboot"  with-
  495.         out turning off the machine.  Press the Ctrl, Alt, and Del keys 
  496.         simultaneously.  Be careful.  Never reboot if you haven't saved 
  497.         whatever you're working on, because it will be lost.  
  498.  
  499.         Changing the Designated Drive
  500.  
  501.         When the computer is first turned on, it will search for files on 
  502.         the default drive.  If you want it to search for files on another 
  503.         drive, you must change the designated drive.
  504.  
  505.  
  506.         DM Users Manual                                          Page 10
  507.         ________________________________________________________________
  508.  
  509.  
  510.         If Drive A is currently the  designated drive, then "A:" will  be 
  511.         the  prompt.  To change the designated drive, type the letter  of 
  512.         the desired drive, followed by a colon, then press Enter.  
  513.  
  514.         A:             (Prompt for current designated drive)
  515.         A:             (to change designated drive to drive C,
  516.                        type "C:" and then press Enter)
  517.         C:             (the new prompt appears, showing that
  518.                        C is now the designated drive) 
  519.  
  520.         Format A Disk
  521.  
  522.         Formatting a blank disk prepares it to be used for your computer.  
  523.         The  disk  is divided into "sectors" which could be  compared  to 
  524.         drawing  lines on a sheet of paper in preparation for  writing  a 
  525.         letter.  Every disk that you use must be formatted.  
  526.  
  527.         WARNING:  Formatting a disk erases everything on the disk.
  528.  
  529.         Dual  Floppy Systems: Your DOS disk should be in Drive A.  Put  a 
  530.         blank  disk  in drive B.  The "A:" prompt should  appear  on  the 
  531.         screen.   If  it doesn't, bring it up. Type: A:  FORMAT  B:  This 
  532.         specifies  that the "FORMAT" program should be executed  for  the 
  533.         disk  in drive B.  Press Enter, and the disk in Drive B  will  be 
  534.         formatted.  
  535.  
  536.         Hard  Disk  Systems: Read warning below before you  do  anything. 
  537.         Then  put a blank disk in Drive A.  Bring up the "C:" prompt  and 
  538.         type:  FORMAT  A: Press Enter, and the disk in Drive  A  will  be 
  539.         formatted.  
  540.  
  541.         WARNING:  You  must  specify Drive A by  typing  the  "A:"  after 
  542.         "FORMAT".  If  you forget the "A:" or if you make a  mistake  and 
  543.         type  "A;"  then the default drive (Drive C) will  be  formatted.  
  544.         Since  this is the hard disk, this means that everything  on  the 
  545.         hard disk will be erased! 
  546.  
  547.         Steps for making a Backup
  548.  
  549.         You  should always make a backup of each of your software  disks.  
  550.         The  backup,  or  working copy, is for  everyday  use.   Put  the 
  551.         original  in  a safe place.  Then, if something  happens  to  the 
  552.         working copy, you can make another copy from the original.
  553.  
  554.         Dual Floppy System:
  555.  
  556.         1) Have  your DOS diskette in Drive A, and a blank  diskette  in
  557.            Drive  B.
  558.         2) Bring up the "A:" prompt and type "DISKCOPY A: B:"
  559.            and  then press the Enter key.  This tells the computer to
  560.            copy the disk in drive A to the disk in drive B.  
  561.         3) Follow the instructions on the screen.  The DM diskette is
  562.            the "source" and the blank diskette is the "target."
  563.  
  564.  
  565.         DM Users Manual                                          Page 11
  566.         ________________________________________________________________
  567.  
  568.  
  569.         Hard Disk System:
  570.  
  571.         1) Have your DM diskette and a blank diskette ready. 
  572.         2) Bring up the "C:" prompt and type "DISKCOPY A: A:" and then 
  573.            press the Enter key.  This tells the computer to copy the disk 
  574.            in drive A to another disk which will later be put in drive A.
  575.         3) Follow the instructions on the screen.  The DM diskette is the 
  576.            "source" and the blank diskette is the "target."
  577.  
  578.         Note:  Your blank disk does not need to be formatted in  advance.         
  579.         The "DISKCOPY" command formats the disk at the same time that the 
  580.         files are being copied.  
  581.  
  582.         Files, Filenames, and Extensions
  583.  
  584.         All programs, text, or data on your disk are contained in  files.   
  585.         A  letter  created by your word processor is in a file, as  is  a 
  586.         list of names and addresses in a database.  A file on a disk  can 
  587.         be  compared  to  a file folder in a drawer.
  588.  
  589.         Every  file  has a filename, which allows the  computer  to  keep 
  590.         track of files.  Filenames may have two parts: the "name" and the 
  591.         "extension."   These  are separated by a  period.   For  example, 
  592.         DM.COM  is DM's filename.  A name may be up to eight  characters, 
  593.         but the extension is limited to three characters.  The  extension 
  594.         is   optional.   All  of  the  following  are  valid   filenames: 
  595.         LETTER.DOC, D.DB, MOMLET, Q, O.K, 123.123. 
  596.  
  597.         Wildcards
  598.  
  599.         Sometime  you may want to give the computer a command  that  will 
  600.         affect  more than one file.  For example, you may want to  delete 
  601.         all the files with the extension .BAK.  Wildcards allow you to  do 
  602.         this  all  at once, rather than going through and  deleting  them 
  603.         one-by-one.  
  604.  
  605.         Two characters, the question mark (?) and the asterisk (*) may be 
  606.         used as "wildcards" in filenames and extensions.
  607.  
  608.         The computer interprets a question mark (?) as "any character" (a 
  609.         wildcard for a single character).  If you had a set of files, for 
  610.         example,  with the names BOB1.LET, BOB2.LET, BOB3.LET, etc.,  you 
  611.         could denote the whole set with the name BOB?.LET.   ????????.??? 
  612.         means "any file." 
  613.  
  614.         The  computer  interprets  the  asterisk  (*)  as  "any  set   of 
  615.         characters" (a wildcard replaces a whole filename or any part  of 
  616.         a  filename).  Therefore, "*.COM" would mean "any file  with  the 
  617.         ".COM"  extension.   "FUN.*" would mean any file with  the  first 
  618.         name "FUN."  *.* means "all files." 
  619.  
  620.  
  621.         DM Users Manual                                          Page 12
  622.         ________________________________________________________________
  623.  
  624.  
  625.         Wildcards (? and *) may not be used to name files.  Rather,  they 
  626.         are only used in commands to select a group of files for  moving, 
  627.         deleting, copying, etc.  Some examples of uses for wildcards  are 
  628.         shown below.  
  629.  
  630.         DEL MAIL.*       (all files beginning with MAIL would be
  631.                          deleted)
  632.  
  633.         DIR TEST?.DOC    (a directory will be displayed for all
  634.                          files starting with TEST with the .DOC
  635.                          extension.) 
  636.  
  637.         COPY *.COM A: B: (all files with the .COM extension would
  638.                          be copied from drive A to drive B.)
  639.  
  640.         ABOUT DIRECTORIES AND SUBDIRECTORIES
  641.  
  642.         A directory keeps track of your files on a disk.  Every disk  has 
  643.         a  directory, which may contain any number of files.  The  direc-
  644.         tory has information about the name, size, location, and date  of 
  645.         creation (or last updating) of all the files on a disk.  
  646.  
  647.         Displaying a Directory using DOS
  648.  
  649.         "DIR" is the DOS command to display the directory of the  current 
  650.         designated drive.  Other commands to show a directory are: 
  651.  
  652.         DIR B:         (Shows directory of Drive B: or whatever 
  653.                        drive is specified)
  654.  
  655.         DIR/P          ("Page mode" pauses when the screen is
  656.                        filled.  Press any key to resume the 
  657.                        directory display.)
  658.  
  659.         DIR/W          ("Wide Display" shows directory of the 
  660.                        current drive in several columns across
  661.                        the screen.  Only filenames are displayed.)
  662.  
  663.         DM's  main purpose is to help you keep track of your  directories 
  664.         better than is possible with DOS alone.  You probably won't  need 
  665.         to  use  the DOS directory display commands too  much  after  you 
  666.         learn DM.
  667.  
  668.         Subdirectories
  669.  
  670.         If you have several different projects, each with its own  files, 
  671.         or if many people are using the same computer, the directory  may 
  672.         become long and unwieldy.  You may want to categorize your  files 
  673.         or  keep  them separate from another  person's.  "Subdirectories" 
  674.         allow  you  to group files separately, much as  you  would  group 
  675.         files in separate drawers of a filing cabinet.  
  676.  
  677.  
  678.         DM Users Manual                                          Page 13
  679.         ________________________________________________________________
  680.  
  681.  
  682.         Subdirectories  are most commonly used on a hard disk, but  disk-
  683.         ettes  may  also have subdirectories.  For the  purpose  of  this 
  684.         discussion, we will assume that your subdirectories are on  Drive 
  685.         C:, the hard drive.  
  686.  
  687.         Any directory may have subdirectories, and this creates a  "tree" 
  688.         structure.   The  "root" is the first level  directory,  and  the 
  689.         subdirectories  of  the  root  directory may  be  thought  of  as 
  690.         branches on the tree.  To carry this idea further, files within a 
  691.         subdirectory are like the leaves on a branch.  
  692.  
  693.         An example of a typical directory structure or "tree" is shown 
  694.         below:
  695.  
  696.                 --ROOT---+-PROGRAMS----+-PROCOMM
  697.                          |             |-TWIN
  698.                          |             |-BASIC
  699.                          |             |-WORDSTAR
  700.                          |
  701.                          +-USERS-------+-TOM
  702.                          |             |-DICK
  703.                          |             |-HARRY--+-GAMES
  704.                          |                      |-ACCOUNTS 
  705.                          +-MUSIC
  706.                          +-GOODIES
  707.                          +-UTIL   
  708.  
  709.         Paths and Pathnames
  710.  
  711.         You can access any file in any subdirectory on your disk.  To  do 
  712.         this,  you  must tell the computer where in the "tree"  that  the 
  713.         file is located.  Starting with the root directory, you must give 
  714.         the  "path"  to the desired file.  The "pathname" is  a  list  of 
  715.         directory  names  separated  by backslashes (\).   In  the  tree 
  716.         above,  the  pathname for the subdirectory named  TWIN  would  be 
  717.         written as: 
  718.  
  719.         C:\PROGRAMS\TWIN
  720.  
  721.         The symbol for the root directory is "\", so the root directory 
  722.         on Drive C is written as "C:\".  A subdirectory's name is written 
  723.         as  "C:\NAME"  (NAME is whatever name you gave to  the  subdirec-
  724.         tory).  
  725.  
  726.         Accessing a Subdirectory
  727.  
  728.         If  you  want  the  computer  to  search  for  files  in  another 
  729.         subdirectory,  you  must  change directories.   The  command  for 
  730.         "change  directory"  is CHDIR or CD, followed  by  the  pathname.  
  731.  
  732.  
  733.         DM Users Manual                                          Page 14
  734.         ________________________________________________________________
  735.  
  736.  
  737.         Suppose  that Harry, who uses the computer with the "tree"  shown 
  738.         above,  wants to play games.  He must type the  change  directory 
  739.         command,  plus  the pathname, to get to his  GAMES  subdirectory.  
  740.         From  the  C: prompt, he will type: 
  741.  
  742.         C:CD USERS\HARRY\GAMES           (change directory command)
  743.         C:\USERS\HARRY\GAMES:            (prompt in new directory)
  744.  
  745.         The symbol for the root directory is "\". So, to return to the 
  746.         root directory, he will type:
  747.  
  748.         C:\USER\HARRY\GAMES: CD\         (command to return to root)     
  749.                      
  750.         Creating a Subdirectory
  751.  
  752.         To create a subdirectory, type the command "MD" (make  directory) 
  753.         and  the  name  that you choose for the  directory.  Suppose  you 
  754.         wanted to name your directory "TEST." From the C: prompt, type: 
  755.  
  756.         C:  MD TEST
  757.  
  758.         Perhaps you want to make a subdirectory within the directory TEST 
  759.         that you just created.  You want to call it NEXTTEST.  From the 
  760.         C: prompt, type:
  761.  
  762.         C:> MD TEST\NEXTTEST
  763.  
  764.         Directory names are limited to eight characters.  The entire 
  765.         pathname is limited to 64 characters.  
  766.  
  767.         Removing a Subdirectory
  768.  
  769.         RD  is  the  "remove directory" command.   The  command  must  be 
  770.         followed  by the pathname, using the same syntax as for making  a 
  771.         directory   or  changing  directories.   You  cannot  be   in   a 
  772.         subdirectory  you are trying to remove and you can only remove  a 
  773.         directory if it is empty.
  774.  
  775.         About the Command Line
  776.  
  777.         DOS  commands are typed next to the prompt.  This is  called  the 
  778.         command  line.   Commands are executed when you press  the  Enter 
  779.         key.  DOS commands are normally typed in one of the two following 
  780.         formats:
  781.  
  782.  
  783.  
  784.         DM Users Manual                                          Page 15
  785.         ________________________________________________________________
  786.  
  787.  
  788.         Format 1: Executing a DOS command
  789.  
  790.         COMMAND [C:][\PATHNAME][\FILENAME]
  791.  
  792.         COMMAND    is the actual DOS command, such as DEL, DIR, CD, etc.  
  793.         [ ]        indicates that this part of the command is optional
  794.         C:         is the name of the required drive, either A:, B: or C:      
  795.         \PATHNAME  is the pathname where the command should execute
  796.         \FILENAME  is the name of the file on which the command should be 
  797.                    executed.
  798.  
  799.         If you typed the command:
  800.  
  801.         DEL C:\GAMES\PACKMAN 
  802.  
  803.         then you would delete the PACKMAN file in the GAMES  subdirectory 
  804.         on drive C:.  If you were already in the GAMES subdirectory, your 
  805.         prompt would be C:\GAMES and it would not be necessary to specify 
  806.         the  drive  and  pathname.   You would only  have  to  type  "DEL 
  807.         PACKMAN".
  808.  
  809.         Format 2: Executing an executable file.
  810.  
  811.         [C:][\PATHNAME\]FILENAME1 [FILENAME2]
  812.  
  813.         [ ]        indicates that this part of the command is optional
  814.         C:         is the name of the required drive, either A:, B:, or C:      
  815.         \PATHNAME  is the pathname where the command should execute
  816.         FILENAME1  is the name of the file (program) that should be
  817.                    executed.  It must be an "executable" file (have the
  818.                    extension .COM, .EXE, or .BAT.)
  819.         FILENAME2  is the name of a data file that may be loaded using 
  820.                    the program in (FILENAME1).
  821.  
  822.         Using our sample "tree" shown earlier, suppose the WORDSTAR 
  823.         subdirectory contained the following files:
  824.  
  825.         WS.COM           (the WordStar word processing program)
  826.         LETTER           (data file for WordStar)
  827.  
  828.         If you typed this command:
  829.  
  830.         C:\PROGRAMS\WORDSTAR\WS LETTER
  831.  
  832.         then  the WS file would be executed with the LETTER file  loaded.  
  833.         If you were already in the WORDSTAR subdirectory, you would  only 
  834.         have  given the command: "WS LETTER".  And, if you didn't want  to 
  835.         load the LETTER file, your command would simply be "WS". 
  836.  
  837.  
  838.  
  839.         DM Users Manual                                          Page 16
  840.         ________________________________________________________________
  841.  
  842.  
  843.                         USING "DM" DIRECTORY MASTER
  844.  
  845.         GETTING STARTED
  846.  
  847.         DM  may be used on any PC/XT/AT compatible system with  at  least 
  848.         128k resident memory.  
  849.  
  850.         This  manual uses a great deal of cross-references, for the  con-
  851.         venience  of readers who choose to skip around.  Those  who  read 
  852.         the manual straight through can probably ignore the references.
  853.  
  854.         Back Up Your DM Disk
  855.  
  856.         Before you begin, make a working copy of your DM program disk for 
  857.         everyday use.  Then put your original in a safe place.  That way, 
  858.         if something happens to the working copy, you'll be able to make 
  859.         another  copy  from  the  original.  (See  "Steps  for  Making  a 
  860.         Backup," pages 10-11.)
  861.  
  862.         Installing DM On Your Hard Drive
  863.  
  864.         Turn  on  the system.  When "C:" appears, insert the DM  disk  in 
  865.         Drive A.  Always install DM in the root directory.  Make sure you 
  866.         are  at  the C:\ prompt and type copy a:*.*. Press  the  Enter 
  867.         key. DM should now be in the root directory. 
  868.  
  869.         The Path Command
  870.  
  871.         It  is  to  your  advantage to be able to  execute  DM  from  any 
  872.         subdirectory you may be in. To do this, you may have to designate 
  873.         a  path in your autoexec.bat file using the dos  "Path"  command. 
  874.         When  using  a hard drive, you may frequently be in  a  directory 
  875.         other  than  the root, where DM is located.  The  "Path"  command 
  876.         allows  you  to  execute  a  program  when  it  is  not  in   the 
  877.         subdirectory you are currently in. If you want to execute DM from 
  878.         any directory, put DM in a directory that your PATH is set up  to 
  879.         access. If you have not set up a path command, refer to your MS-
  880.         DOS  manual or your friendly neighborhood computer wizard as  to 
  881.         how to do this.
  882.  
  883.         Calling up the Program
  884.  
  885.         Dual  Floppy Systems:  Put your MS-DOS diskette in Drive  A,  and 
  886.         turn  on  the system.  When "A:" appears, insert the DM  disk  in 
  887.         Drive  A.  Type "DM" and press the Enter key.  This calls up  the 
  888.         DM program.
  889.  
  890.         Hard  Disk Systems: Just type "DM".  (See above section  entitled 
  891.         "The Path Command" for important information.)
  892.  
  893.  
  894.         DM Users Manual                                          Page 17
  895.         ________________________________________________________________
  896.  
  897.  
  898.         When  the  DM program comes up, three windows will  appear.   The 
  899.         left-hand  window is the File Display Window.  The names  of  the 
  900.         files  in  the  current  directory  will  be  displayed  here  in 
  901.         alphabetical order.  The upper right window is the Status Window.  
  902.         It  shows which directory is being read, the size of  the  files, 
  903.         and other statistical information.  The lower right window is the 
  904.         Popup Help Window for DM commands.  
  905.  
  906.         Finding the Help Screens
  907.  
  908.         Dm uses two types of Help. One is full screen help (F1), and  the 
  909.         other  is a popup help screen (lower right screen) which pops  up 
  910.         each time you use a DM command. Press the F1 key once to  display 
  911.         the first help screen, then press it again to get the second help 
  912.         screen, and so on.
  913.  
  914.         Getting Out of the Program
  915.  
  916.         Press the Q key (Quit DM) to escape the program and return to MS- 
  917.         DOS.   You may also press the Escape key (Esc) twice to exit  the 
  918.         program.
  919.  
  920.         Scanning the Directory
  921.  
  922.         You  may scan the list of filenames in the File Window using  the 
  923.         page up (Pg Up) and page down (Pg Dn) keys, and the Home and  End 
  924.         keys.   Ctrl Home takes you to the top of the list and  Ctrl  End 
  925.         takes  you to the bottom.  The up arrow and down arrow keys  move 
  926.         the pointer one line at a time.   
  927.  
  928.         Marking Files
  929.  
  930.         If  you want to delete, copy or move several files at  once,  you 
  931.         have  to "mark" the files first.  This tells the  computer  which 
  932.         files you want to copy, move or delete.  
  933.  
  934.         To  mark a file, position the pointer next to that  file.   Press 
  935.         the right arrow -> key.  The name of the file will be highlighted 
  936.         to  indicate that it has been "marked."  Press the left arrow  <- 
  937.         key  to un-mark a file.  You may mark as many files as you  wish.  
  938.         Ctrl -> marks all files in the current directory, and Ctrl <- un-
  939.         marks all files.  
  940.  
  941.         COPYING, DELETING AND MOVING FILES
  942.  
  943.         Copy a File
  944.  
  945.         If you want to copy a file, use the up arrow and down arrow  keys 
  946.         to  position  the pointer next to the file to  be  copied.   Then 
  947.         press the C key.  The message "Press down arrow to copy  filename 
  948.         to another filename. To Path:" will appear.  Pressing down  arrow 
  949.         allows you to copy a file to the same or another filename  within 
  950.         the  same subdirectory. "Path" means the place where you want  to 
  951.         put  the  file.   Type the name of the disk drive  or  drive  and 
  952.  
  953.  
  954.         DM Users Manual                                          Page 18
  955.         ________________________________________________________________
  956.  
  957.  
  958.         subdirectory  that  the file is to be copied to, then  press  the 
  959.         Enter key.  The file will be copied.  
  960.  
  961.         (New Users:  See "Paths and Pathnames," page 13.)
  962.  
  963.         Dual Floppy Systems:  If the file being copied is on the disk  in 
  964.         Drive  A,  and you want to copy it to the disk in drive  B,  then 
  965.         type "B:" when "To Path" appears.  You must have a formatted disk 
  966.         in Drive B.
  967.  
  968.         Hard Disk Systems:  If you are copying from a disk in Drive A  to 
  969.         the  hard disk, then type "C:" when "To Path:" appears.   If  you 
  970.         are  copying from the hard disk to a disk in Drive A,  then  type 
  971.         "A:"  when "To Path" appears.  You must have a formatted disk  in 
  972.         drive A.
  973.  
  974.         Delete a File
  975.  
  976.         To  delete  a  file,  use the up arrow and  down  arrow  keys  to 
  977.         position  the pointer next to the file you want to  delete.   Then 
  978.         press  the  D key.  The message "Delete (filename)?  (Y/N)"  will 
  979.         appear.  Press Y for yes and the file will be deleted. 
  980.  
  981.         Delete Many Files at Once
  982.  
  983.         Mark  (highlight)  all the files that you want  to  delete,  then 
  984.         press the Alt D key.  "Ready to Delete Marked Files? (Y/N)"  will 
  985.         appear.  Type "Y" for yes.  All marked files will be deleted. 
  986.  
  987.         Copy Many Files at Once
  988.  
  989.         "Mark"  (highlight)  all the files that you want  to  copy,  then 
  990.         press the Alt C key.  The message "Copy Marked Files.  To  Path:" 
  991.         will appear.  Type the name of the disk drive to which the  files 
  992.         should be copied.  Press the Enter key.  All marked files will be 
  993.         copied to the specified disk drive.  The following conventions 
  994.         should be used to type the Path.
  995.  
  996.         A:  = Drive A  (usually floppy drive)
  997.         B:  = Drive B  (usually floppy drive)
  998.         C:  = Drive C  (hard drive)
  999.         C:\ = Drive C (root directory of hard drive)
  1000.         C:\NAME = Subdirectories of Drive C (NAME is the name of           
  1001.                       subdirectory) 
  1002.  
  1003.         (New Users: See "About Directories and Subdirectories," pages  12-
  1004.         15.) 
  1005.  
  1006.         Moving Files
  1007.  
  1008.         You  may  want to move files from the root directory  to  a  sub-
  1009.         directory  or vice versa, or from subdirectory  to  subdirectory.  
  1010.         Mark (highlight) the files to be moved, then the press Alt M key.  
  1011.         The  message "Move Marked Files. To Path:" will appear.  Type  in 
  1012.  
  1013.  
  1014.         DM Users Manual                                          Page 19
  1015.         ________________________________________________________________
  1016.  
  1017.  
  1018.         the  name  of the path (as described above) and press  the  Enter 
  1019.         key.  The files will be "moved," which means they will be  copied 
  1020.         to  the  directory  you specified and deleted  from  the  current 
  1021.         directory.  
  1022.  
  1023.         Copying More Files to the Same Path
  1024.  
  1025.         Suppose  you have just copied a group of files, and you  want  to 
  1026.         immediately  copy more files to the same path.  DM has a  feature 
  1027.         that allows you to copy files to the same path without having  to 
  1028.         retype the pathname each time you copy files.  This is helpful if 
  1029.         you  are  making backups from the hard disk onto  several  floppy 
  1030.         disks.
  1031.  
  1032.         If  you  have already copied a group of files, and want  to  copy 
  1033.         more  files  to the same path, mark the files and  press  Alt  C.  
  1034.         When  the message "To Path:" appears, simply hit the  Enter  key.  
  1035.         The files will be copied to the path you specified the last  time 
  1036.         you copied files.  
  1037.  
  1038.         QUICK AND EASY FEATURES 
  1039.  
  1040.         Sorting the Directory
  1041.  
  1042.         The order in which the directory is displayed is shown as "Sort:" 
  1043.         in  the upper right window.  If you want the directory listed  in 
  1044.         some other order, press the S key.  Five choices appear.
  1045.  
  1046.           1) Name -    alphabetical order by filename.  This is the 
  1047.                        default  sort order, which means it  is  automa-
  1048.                        tically sorted this way unless you change it.
  1049.           2) Ext -     alphabetical order by extension.  This is helpful 
  1050.                        if  you want all the files with the same  exten-
  1051.                        sion  to appear together. 
  1052.           3) Date -    files are listed in chronological order.
  1053.           4) Size -    files are listed from smallest to largest.
  1054.           R) Reverse   (1,2,3,4,R)? - reverse the current order of the files
  1055.                        or select a number to reverse sort in another order.
  1056.                        "R" is a toggle key, press once to enter and again
  1057.                        to exit reverse sort mode. 
  1058.          
  1059.         (New Users: see "Files, Filenames and Extensions," page 11.)
  1060.  
  1061.         Renaming Files
  1062.  
  1063.         To rename a file, place the pointer at the desired file and  press 
  1064.         the R (Rename) key.  Then type in the desired new name and  press 
  1065.         Enter.   Use  the  arrow keys to position the  pointer,  and  the 
  1066.         Backspace (<--) or Delete (Del) key to erase unwanted characters. 
  1067.         You may move up and down the list, changing the names of as  many 
  1068.         files  as desired. Two files cannot share the same name.  If  you 
  1069.         try, you will get an error message "access denied."  Press the F3 
  1070.         key if you want to copy the name (not the extension) of the  file 
  1071.         directly  above  the  one you're working on.  
  1072.  
  1073.  
  1074.         DM Users Manual                                          Page 20
  1075.         ________________________________________________________________
  1076.  
  1077.  
  1078.  
  1079.         View a Data File
  1080.  
  1081.         If  you  want to view a text file you can set up DM to  run  your 
  1082.         favorite  VIEW program on a selected file.  The program  must  be 
  1083.         installed  in  the  same  directory as DM or  its  path  must  be 
  1084.         specified during the setup routine.  To set up your VIEW program, 
  1085.         choose X (Extra Functions) and then choose V (Set VIEW  Program).  
  1086.         The  message "Input the Command for your favorite  VIEW  program" 
  1087.         will appear.  Type in the name of your program, (and its path, if 
  1088.         necessary),  same as if were being executed from DOS.  [Examples: 
  1089.         NW1 or C:\NW\NW1]   
  1090.  
  1091.         However,   program   files  (those  with  .COM,  .EXE   or   .BAT 
  1092.         extensions),  data  base files and spreadsheet  data  files  will 
  1093.         probably  be  unrecognizable.  You may not change  a  file  using 
  1094.         View.  
  1095.  
  1096.         Edit a Data File
  1097.  
  1098.         If  you want to modify a text file you can set up DM to run  your 
  1099.         favorite  EDIT program on a selected file.  The program  must  be 
  1100.         installed  in  the  same  directory as DM or  its  path  must  be 
  1101.         specified during the setup routine.  To set up your EDIT program, 
  1102.         choose X (Extra Functions) and then choose E (Set EDIT  Program).  
  1103.         The message "Input the Command for your favorite EDITOR  program" 
  1104.         will appear.  Type in the name of your program, (and its path, if 
  1105.         necessary),  same as if were being executed from DOS.  [Examples: 
  1106.         Edit or C:\NW\Edit]   
  1107.  
  1108.         Patch a File
  1109.  
  1110.         If  you  want  to  patch a file you can set up  DM  to  run  your 
  1111.         favorite  PATCH program on a selected file.  The program must  be 
  1112.         installed  in  the  same  directory as DM or  its  path  must  be 
  1113.         specified  during  the  setup  routine.  To  set  up  your  PATCH 
  1114.         program, choose X (Extra Functions) and then choose P (Set  PATCH 
  1115.         Program).  The message "Input the Command for your favorite  FILE 
  1116.         PATCH  program" will appear.  Type in the name of  your  program, 
  1117.         (and its path, if necessary), same as if were being executed from 
  1118.         DOS. [Examples: Patch or C:\UTIL\Patch]   
  1119.  
  1120.         Changing Dates 
  1121.  
  1122.         Position  the pointer at the file to be changed and press  the  T 
  1123.         (Change  Date) key.  Then you can type in the desired  date.   If 
  1124.         you want today's date, press the F2 key.  If you want the date of 
  1125.         the  file directly above the one you're working on, press the  F3 
  1126.         key.  You may move up and down the list, changing the date on any 
  1127.         file.  Press Enter when finished.
  1128.  
  1129.  
  1130.         DM Users Manual                                          Page 21
  1131.         ________________________________________________________________
  1132.  
  1133.  
  1134.  
  1135.         Disk Statistics - The Status Window
  1136.  
  1137.         Disk  statistics for the current drive are in the Status  Window.  
  1138.         The  "Size of Files" and "Free Space" figures are shown  in  "k." 
  1139.         One "k" equals 1024 characters.  Therefore, 20k would mean 20,480 
  1140.         characters.  Just below "Path", the "Size" of the file  currently 
  1141.         at the pointer is shown in actual number of characters (bytes).
  1142.  
  1143.         The  figure under the "Total" column for "Size of  Files",  shows 
  1144.         the  total k used by all files in the current  subdirectory.  The 
  1145.         same  figure under the "Marked" column shows the number of  k  of 
  1146.         all  marked  files.  Note: This figure is the  actual  amount  of 
  1147.         space required on a floppy if you are copying the marked files to 
  1148.         a  floppy disk.  The "Marked" figure may differ from the  "Total" 
  1149.         figure,  when all files in the subdirectory are marked because  a 
  1150.         hard  disk uses a minimum of 2k clusters for each file,  while  a 
  1151.         floppy drive uses a minimum of only 1k clusters.
  1152.  
  1153.         Number  of Files under the "Total" column represents  the  actual 
  1154.         number  of  files  in the subdirectory.  The  same  figure  under 
  1155.         "Marked"  represents the total number of files currently  marked.  
  1156.         "Size:"  shows  the  actual  number of  characters  in  the  file 
  1157.         currently  indicated by the pointer.  "Free:" shows the amount  of 
  1158.         space, in k, still available on the current disk.  
  1159.  
  1160.         Determining Free Space on a Disk
  1161.  
  1162.         If  you  want to know the amount of free space on  another  disk, 
  1163.         press the F (Freespace) key.  The message "Disk Statistics for 
  1164.         Drive" will appear.  Type in the name of the desired drive (A, B, 
  1165.         or  C),  and  statistics  for the disk  in  that  drive  will  be 
  1166.         displayed.  (See "Copy Many Files at Once," page 18.) 
  1167.  
  1168.         For example, a disk in drive A might read:
  1169.  
  1170.                      Total: 354k         Cluster Size: 1024
  1171.                      Free:  120k         Tot Clusters:  354
  1172.                      Used:  234k         Percent Free:  33.8%
  1173.  
  1174.         The  "Total"  shows  the capacity of the disk.  When  a  file  is 
  1175.         created, space for it is allocated in chunks, called  "clusters."  
  1176.         Therefore, the "Cluster Size" is the minimum amount of space that 
  1177.         may  be taken up by a file.  (If the cluster size is 1024  bytes, 
  1178.         then a file with only 500 bytes will still be considered to  take 
  1179.         up  1024  bytes, or one cluster.)  The Freespace command  (F)  is 
  1180.         very helpful when you need to make sure there is adequate room on 
  1181.         a disk intended to receive copied files.
  1182.  
  1183.  
  1184.         DM Users Manual                                          Page 22
  1185.         ________________________________________________________________
  1186.  
  1187.  
  1188.         MOVING AROUND
  1189.  
  1190.         Goto Filename 
  1191.  
  1192.         Rather  than  scrolling through a lengthy directory, you  may  go 
  1193.         directly  to  a specific file using the  Goto  Filename  feature.  
  1194.         Press the G key, then type in the name of the desired file. Press 
  1195.         enter, and the pointer will move to that filename.
  1196.  
  1197.         Inserting a New Disk in the Floppy Drive
  1198.  
  1199.         If you change the disk in your floppy drive, you have to let  the 
  1200.         computer  know  that there's a different disk in the  drive  now.  
  1201.         Press  the L key (Re-read Directory) to display the directory  of 
  1202.         the new disk.
  1203.  
  1204.         Changing Disk Drives
  1205.  
  1206.         The name of the current designated drive is in the Status Window, 
  1207.         shown as "Path:".  If you want to scan the files on another  disk 
  1208.         drive,  press the F5 (Change Disk) key.  Type in the name of  the 
  1209.         desired disk drive (such as A, B, or C).  The new directory  will 
  1210.         be displayed in the File Window.
  1211.  
  1212.         Changing the Path
  1213.  
  1214.         If you want to display the files in a subdirectory, then you have 
  1215.         to  change the path.  This is similar to changing the disk  drive 
  1216.         (see above).  Press the F6 (Change Path) key.  This message  will 
  1217.         appear:
  1218.  
  1219.         Change drive, path, or mask.
  1220.         Usage: Drive:\Path\Mask
  1221.  
  1222.         The "mask" will be explained later.  Ignore it for now.  Type  in 
  1223.         the  desired  pathname, such as C:\NW then press the  Enter  key.  
  1224.         (See "About Directories and Subdirectories," pages  12-15,  and 
  1225.         "Paths and Pathnames," page 13.)
  1226.  
  1227.         Changing the Mask
  1228.  
  1229.         Perhaps you have a big directory and don't want DM to show  every 
  1230.         file. You may display a partial directory by "changing the mask." 
  1231.  
  1232.         The  "mask" determines which files in a given directory will  ap-
  1233.         pear  in the File Window.  Normally, all files are shown, so  the 
  1234.         default  mask  is  "*.*"  (meaning  "every  filename,  and  every 
  1235.         extension").   The mask currently in use is shown in  the  Status 
  1236.         Window.  
  1237.  
  1238.         If you want to change the mask so that only certain filenames or 
  1239.         extensions are displayed, press the F6 (Change Path) key.  This 
  1240.         message will appear:
  1241.  
  1242.  
  1243.  
  1244.         DM Users Manual                                          Page 23
  1245.         ________________________________________________________________
  1246.  
  1247.  
  1248.         Change drive, path, or mask.
  1249.         Usage: Drive:\Path\Mask
  1250.  
  1251.         Follow the usage example when typing in the drive, path, and  the 
  1252.         desired  "mask".  The mask should be a filename with  the  appro-
  1253.         priate  embedded  wildcards.  Then  press  the  Enter  key.  (See 
  1254.         "Wildcards," pages 11, 12 and 24.)    
  1255.  
  1256.         Example:  if you only want to display files with the .COM  exten-
  1257.         sion, then press F6, and specify "*.COM" as the mask.  
  1258.  
  1259.         Tree Mode
  1260.  
  1261.         The  Tree Mode feature displays a list of subdirectories for  the 
  1262.         current drive.  It may also be used instead of the "Change  Path" 
  1263.         command to jump to a subdirectory.  
  1264.  
  1265.         Toggle the F7 (Tree Mode) key "on and off" to enter and exit  the 
  1266.         Tree Mode.  A list of all the subdirectories on the current drive 
  1267.         will appear in the File Window.
  1268.  
  1269.         If, while  you are in the Tree Mode, you want to know if a  given 
  1270.         subdirectory has any further subdirectories, position the pointer 
  1271.         next to the name of the desired subdirectory, and press the right 
  1272.         arrow  ->  key.  Any further subdirectories  will  be  displayed. 
  1273.         Press the left arrow <- to return to the previous directory.
  1274.  
  1275.         You may want to look at the filenames in one of your subdirector-
  1276.         ies.  Position the pointer next to the desired subdirectory, then 
  1277.         press  the  Enter  key.  You will exit the  Tree  Mode  and  jump 
  1278.         directly into that subdirectory.  This is an alternative to using 
  1279.         the "Change Path" (F6) command.
  1280.  
  1281.         Tree Mode Help Screen
  1282.  
  1283.           F7    Enter and Exit Tree Mode 
  1284.           R     Rename Subdirectory
  1285.           ->    Jump to SubDir - move to the next tier of subdirectories
  1286.           <-    Jump to SubDir toward Root - move to the next tier of 
  1287.                 subdirectories toward the root
  1288.           RET   Jump to SubDir and Exit Tree Mode - move to the 
  1289.                 subdirectory indicated by the pointer and return to the 
  1290.                 regular mode
  1291.           \     Jump to Root Directory - move to the root directory
  1292.  
  1293.  
  1294.         DM Users Manual                                          Page 24
  1295.         ________________________________________________________________
  1296.  
  1297.  
  1298.         NEAT TRICKS
  1299.  
  1300.         Wildcard Mark
  1301.  
  1302.         You  may mark (highlight) a group of files at one time  with  the 
  1303.         wildcard  feature.   Wildcards are useful if you  want  to  copy, 
  1304.         move,  delete or sort a specific group of files  whose  filenames 
  1305.         which  have  common  characteristics.   You  can  substitute  the 
  1306.         wildcard symbols (* and ?) into a filename, and the computer will 
  1307.         choose all files that fit into that category.  
  1308.  
  1309.         To use the wildcard feature, press W (Wildcard Mark), then type 
  1310.         the filename with the desired wildcards (* or ?) embedded in the 
  1311.         proper  place.  Press Return, and files will be marked.  Example:  
  1312.         Many word processors create an automatic backup file. Suppose you 
  1313.         want  to  delete all your files that have the  ".BAK"  extension.  
  1314.         You  would  press the W key, then type "*.BAK." This  reads  "any 
  1315.         file  that  has  the .BAK extension."   All .BAK  files  will  be 
  1316.         marked  (highlighted),  and ready for deletion. (New  Users:  see 
  1317.         "Wildcards," pages 11-12.)
  1318.  
  1319.         Reversing Marks
  1320.  
  1321.         The "Reverse all Marks" feature marks (highlights) all files that 
  1322.         are  not marked, and "un-marks" all files that are  marked.   You 
  1323.         can  use  this feature if you want to copy, move  or  delete  all 
  1324.         except  a few files.  First, mark (highlight) only the files  you 
  1325.         don't  want to copy, move or delete. Then press the X key  (Extra 
  1326.         Functions), and choose option R (Reverse all Marks). 
  1327.         You can use a combination of the "Wildcard Mark" and the "Reverse 
  1328.         all  Marks"  features.  Suppose you wanted to  delete  all  files 
  1329.         except  those with the .COM extension.  First, you would use  the 
  1330.         wildcard  mark to mark .COM files, then reverse the marks.   Then 
  1331.         all non-.COM files would be marked, ready for deleting.  
  1332.  
  1333.         Changing Colors on the Screen
  1334.  
  1335.         If  you have a color monitor, you may change DM's colors.   Press 
  1336.         the  X (Extra Functions) key, then choose option C (Set  Colors).  
  1337.         The Color Menu will appear:
  1338.  
  1339.                   1 Turn Color Off
  1340.                   2 Background Color            3 Border Color
  1341.                   4 HiVideo Color               5 LoVideo Color
  1342.                   Esc Exit
  1343.  
  1344.         DM  comes up automatically in color on a color monitor.  You  can 
  1345.         change  the  colors of the background, the border,  the  bold  or 
  1346.         highlighted  text (HiVideo), or the regular text (LoVideo).   You 
  1347.         may choose between 15 different colors.  When you have the colors 
  1348.         the  way  you want them, press the Esc key to exit to  the  Extra 
  1349.         Functions  menu, then type "S" to save your new configuration  to 
  1350.         disk.  Saving  the configuration insures that  the  program  will 
  1351.         always come up with your new colors on the screen.  
  1352.  
  1353.  
  1354.         DM Users Manual                                          Page 25
  1355.         ________________________________________________________________
  1356.  
  1357.  
  1358.         EXECUTING DOS COMMANDS AND RUNNING PROGRAMS
  1359.  
  1360.         New Users:  (See "About The Command Line," pages 14-15.)
  1361.  
  1362.         Execute a DOS Command
  1363.  
  1364.         You  may  execute any DOS command directly from the  DM  program.  
  1365.         Press  the  F4  (DOS Command) key, and  then  type  the  desired 
  1366.         command,  just  as  you would from DOS.   Press  Enter,  and  the 
  1367.         command will be executed.  When it is finished, press any key  to 
  1368.         return  to  DM,  exactly where you left  off.   Note:   For  this 
  1369.         feature to work, you must have the COMMAND.COM file on your  hard 
  1370.         disk or the disk that was used to boot the system.
  1371.  
  1372.         Executing a File
  1373.  
  1374.         You  don't have to type the full DOS command to execute  a  file.  
  1375.         Instead,  you may position the pointer next to the file that  you 
  1376.         want  to execute, then press the F3 (Execute File) key.   If  the 
  1377.         file  is  executable, (if it has an extension of .EXE,  .COM,  or 
  1378.         finished running the program, you will automatically return to DM 
  1379.         exactly where you left off.  (If the file is not executable, 
  1380.         nothing will happen.)  
  1381.  
  1382.         This feature executes a file in the same manner as if you were in 
  1383.         DOS.   When you press F3, the filename appears in the Popup  Help 
  1384.         Window. At that time, you may press the Enter key to execute  the 
  1385.         file,  or,  if you wish, you may type more  parameters  onto  the 
  1386.         command line, such as a pathname or the name of a data file to be 
  1387.         loaded  and  run.   Use  standard DOS  syntax  if  you  type  any 
  1388.         additions to the command.
  1389.  
  1390.         For  example, suppose you are marking files on a disk in drive  C 
  1391.         and you realize you don't have a formatted disk to copy them  to.  
  1392.         To continue your project you must first format a disk in drive A.  
  1393.         (The FORMAT program must be in the current directory on Drive C.) 
  1394.         Place  the  pointer next to the FORMAT file, and press  F3.   The 
  1395.         following message will appear:
  1396.  
  1397.                      ___k Memory Available.
  1398.                      Type Text Into Command Line.
  1399.                      FORMAT _
  1400.  
  1401.         You will have to type A: at the cursor to indicate that you  want 
  1402.         the  disk in drive A formatted.  Then press the Enter  key.   The 
  1403.         line  "___k Memory Available" tells you how much resident  memory 
  1404.         (RAM),  in "k," is available to execute the file at the  pointer.  
  1405.         If  the file you've picked is larger than the  available  memory, 
  1406.         you can't execute it.  The amount of memory available depends  on 
  1407.         what  kind  of  computer you have.  DM takes  up  about  100k  of 
  1408.         memory,  so if your computer only has 128k of RAM, don't plan  on 
  1409.         being  able  to execute anything except the  smallest  of  files.  
  1410.         Computers  with  256k may have some  difficulty  executing  large 
  1411.         files. Those with 512k or 640k shouldn't have any trouble at all.
  1412.  
  1413.  
  1414.         DM Users Manual                                          Page 26
  1415.         ________________________________________________________________
  1416.  
  1417.  
  1418.  
  1419.         THE PROGRAMMABLE FUNCTION KEYS
  1420.  
  1421.         You  may custom program up to 30 keys to do special  tasks.   You 
  1422.         can  program  these  keys to execute any  software  program,  DOS 
  1423.         command  or  to execute a batch file which will  then  execute  a 
  1424.         string of commands. These keys can be programmed so that you  can 
  1425.         position  the pointer next to a data file, press a Function  Key, 
  1426.         and run the appropriate software on that file. 
  1427.  
  1428.         The 30 keys available for programming are the Alternate  Function 
  1429.         keys  (Alt F1 to Alt F10), the Control Function keys (Ctrl F1  to 
  1430.         Ctrl F10) and the Shift Function Keys (Shft F1 to Shft F10).  
  1431.  
  1432.         From  the  DM  Opening Screen, press the "Tab" key  to  view  the 
  1433.         Programmable  Function  Key  Settings. This screen  is  only  for 
  1434.         viewing  the Settings. For onscreen "help" on how to program  the 
  1435.         Function Keys, go to Help Screen No. 2 by pressing F1 twice. 
  1436.  
  1437.         When  you "program" a key, you will be writing a command to  tell 
  1438.         the computer what to do when that key is pressed.  You will write 
  1439.         commands  using  regular DOS syntax for the command  line.   (See 
  1440.         "About the Command Line," pages 14-15.)  
  1441.  
  1442.         At the same time that you write a DOS command for a key, you will 
  1443.         also need to write the "help text."  This will appear on the help 
  1444.         screen so that you will remember what the key does.  
  1445.  
  1446.         You  may want to program a key to execute a file that takes up  a 
  1447.         lot of memory.  Since DM takes up about 100k of RAM, be sure that 
  1448.         your  computer has enough memory to execute your commands.   (See 
  1449.         "Execute a File," page 25.)  
  1450.  
  1451.         In  the examples below, we will assume that you have a hard  disk 
  1452.         computer  with at least 512k of RAM.  Here are a couple  of  uses 
  1453.         for  the Programmable Keys.  The DOS commands and help  text  are 
  1454.         included.  
  1455.  
  1456.         Command       Help Text      Explanation/Use
  1457.  
  1458.         FORMAT A:     Format         Formats a disk in drive A.  This is 
  1459.                                      helpful if you have files marked to 
  1460.                                      be copied to a floppy disk, and have 
  1461.                                      forgotten to format a disk.
  1462.  
  1463.         DIR A:/P      Dir A:         Reads the directory of the disk in 
  1464.                                      drive A, pausing when the screen is 
  1465.                                      filled.
  1466.  
  1467.  
  1468.  
  1469.         DM Users Manual                                          Page 27
  1470.         ________________________________________________________________
  1471.  
  1472.  
  1473.         For  practice,  let's  program Function Keys for  the  two  above 
  1474.         examples.   Press the F8 (Edit Commands) key.  You will be  asked 
  1475.         to pick an option:
  1476.  
  1477.                           1 Change Alt Function Keys
  1478.                           2 Change Ctrl Function Keys
  1479.                           3 Change Shft Function Keys
  1480.                           4 Change AutoRun Commands
  1481.  
  1482.         Don't choose option 4 now.  Instructions for the Autorun Key come 
  1483.         later.  For this practice session, let's program the Alt  F1  and 
  1484.         Alt  F2 keys.  Therefore, choose Option 1, "Change  Alt  Function 
  1485.         Keys."  The following display will appear in the File Window.
  1486.  
  1487.                 ================================
  1488.                 |  Esc to Exit     Help Line: 1 
  1489.                 |  Alt F1 .... _
  1490.                 |  Alt F2 ....
  1491.                 |  Alt F3 ....
  1492.                 |
  1493.  
  1494.         You will type in your help text and DOS commands on these  lines.  
  1495.         The first line is for the help text for the Alt F1 key.  The next 
  1496.         line  is the DOS command for the Alt F1 key.  Use the arrow  keys 
  1497.         to position the cursor on the desired line.  The "line guide"  in 
  1498.         the  upper right-hand corner of the window tells you  which  line 
  1499.         the cursor is on.  Using our two examples, type the help text  on 
  1500.         the  help line and the command on the command line for each  key, 
  1501.         as shown below.  
  1502.  
  1503.                 ================================
  1504.                 |  Esc to Exit  Command Line: 2 
  1505.                 |
  1506.                 |  Alt F1 ......Format
  1507.                 |  FORMAT A:
  1508.                 |  Alt F2 ......Dir A:
  1509.                 |  DIR A:/P _
  1510.                 |  Alt F3 ......
  1511.                 |
  1512.  
  1513.         When you've finished typing in the help text and commands,  press 
  1514.         the  Esc  key.   Then  test your  newly  programmed  keys.  After 
  1515.         testing, you must save the configuration of your newly programmed 
  1516.         Function Keys to disk in order for them to be there the next time 
  1517.         you  use  the program. Type "F8" and choose option (5)  "Save  to 
  1518.         DM.COM."
  1519.  
  1520.         Programming with Variables
  1521.  
  1522.         The Programmable Function Keys allow you to execute programs  and 
  1523.         DOS  commands  on  files.   This may  be  accomplished  by  using 
  1524.         variables.   The  variable {F}, means filename.  This  tells  the 
  1525.         computer to perform a command on whatever filename is next to the 
  1526.         pointer.
  1527.  
  1528.  
  1529.         DM Users Manual                                          Page 28
  1530.         ________________________________________________________________
  1531.  
  1532.  
  1533.         Suppose  that you want to program the Ctrl F4 key to execute  the 
  1534.         WordStar  Word Processor (filename WS).  You want to be  able  to 
  1535.         position  the  pointer next to any of your  WordStar  data  files 
  1536.         (your  letters, reports, etc.) and then, when you press the  Ctrl 
  1537.         F4  key, the computer executes the word processor and  opens  the 
  1538.         file  next to the pointer.  Your DOS command for the Ctrl F4  key 
  1539.         would read:  WS {F} 
  1540.  
  1541.         The following are valid variables for DM.  Variables used in the 
  1542.         command line must be put in brackets {}.
  1543.  
  1544.                   {F} = FileName             {P} = Path
  1545.                   {T} = Type in Text         {D} = Drive
  1546.                   {N} = Name no Ext          {E} = Ext no Name
  1547.                   {S} = Allow Program to Change Subdirectory
  1548.                   {A} = Press Any Key to Return to DM
  1549.  
  1550.         The chart below shows some uses of the Programmable Function Keys 
  1551.         using variables.  
  1552.  
  1553.          Command       Help Text      Explanation/Use
  1554.  
  1555.          TREE {A}      List Tree     Executes the Tree program, which 
  1556.                                      displays all the directories and 
  1557.                                      subdirectories on the disk in a 
  1558.                                      "tree" structure.  Pauses before 
  1559.                                      returning to DM.
  1560.  
  1561.          CHKDSK {A}    Chkdsk        Tells how much space is used up on 
  1562.                                      the disk, and and how much  memory 
  1563.                                      is free.  Pauses before return-
  1564.                                      ing to DM.
  1565.          
  1566.          BASIC {F}     Basic         Executes the Basic program and 
  1567.                                      loads the data file next to the 
  1568.                                      pointer.
  1569.          
  1570.          WS {F}        Word Star     Executes the Word Star word 
  1571.                                      processor, and loads the data
  1572.                                      file next to the pointer.
  1573.  
  1574.         To continue the practice programming session, the above four com-
  1575.         mands and help text could be entered for the Alt F3, Alt F4,  Alt 
  1576.         F5, and Alt F6 keys on the Edit Commands (F8) menu.  Press F8 and 
  1577.         choose Option 1.  
  1578.  
  1579.  
  1580.         DM Users Manual                                          Page 29
  1581.         ________________________________________________________________
  1582.  
  1583.  
  1584.                 ================================
  1585.                 |  Esc to Exit  Command Line: 2 
  1586.                 |
  1587.                 |  Alt F1 ......Format
  1588.                 |  FORMAT A:
  1589.                 |  Alt F2 ......Dir A:
  1590.                 |  DIR A:/P
  1591.                 |  Alt F3 ......List Tree 
  1592.                 |  TREE {A}
  1593.                 |  Alt F4 ......Chkdsk
  1594.                 |  CHKDSK {A}
  1595.                 |  Alt F5 ......Basic
  1596.                 |  BASIC {F}
  1597.                 |  Alt F6 ......Word Star
  1598.                 |  WS {F} 
  1599.  
  1600.         There are many other possibilities for the Programmable  Function 
  1601.         Keys.   Decide  what tasks you would like your keys  to  do.   It 
  1602.         might help to make a chart like the ones above.  Then enter  your 
  1603.         chosen commands and help text as shown in the examples.  
  1604.  
  1605.         If you are going to be using software in one directory and  files 
  1606.         in  another, you will need to specify the drive and path in  your 
  1607.         DOS commands.  They were omitted from the examples given above 
  1608.         for the sake of simplicity.  The above commands with pathnames 
  1609.         might read:
  1610.  
  1611.                      C:\UTIL\TREE {A}
  1612.                      C:\UTIL\CHKDSK A: {A}
  1613.                      C:\BASIC {F}
  1614.                      C:\WS {F} 
  1615.  
  1616.         It is recommended that you keep your software in the root  direc-
  1617.         tory if you plan to execute it with the function keys.
  1618.  
  1619.         When  you're finished, press the Esc key.  Then test  your  newly 
  1620.         programmed function keys.  You may need to go back and  fine-tune 
  1621.         some of your commands.
  1622.  
  1623.         Saving Your Programming
  1624.  
  1625.         When you are happy with the way the keys work, then you are ready 
  1626.         to  "save"  the changes.  If you don't save them, they  won't  be 
  1627.         there  next time you use DM.  However, once they're  saved,  they 
  1628.         can't be accidentally changed until you "save" something new.
  1629.  
  1630.         To save your Custom Programmed Function Keys, press the X (Extra 
  1631.         Functions) key.  Choose the option S (Save Configuration).  Your 
  1632.         changes will be saved to disk.  
  1633.  
  1634.         Limitations of the Programmable Function Keys
  1635.  
  1636.         Since  DM  takes up about 100k of memory, it uses up  space  that 
  1637.         would  ordinarily  be used to execute your program.   It  is  not 
  1638.  
  1639.  
  1640.         DM Users Manual                                          Page 30
  1641.         ________________________________________________________________
  1642.  
  1643.  
  1644.         recommended  that you use DM to execute files for  everyday  use.  
  1645.         In  other words, you should execute your programs  directly  from 
  1646.         DOS  to work on your database files, spreadsheet files,  or  word 
  1647.         processor  files.  The purpose of executing a file directly  from 
  1648.         DM  is to look at a file to see what's in it, not to work on  it.  
  1649.         DM can only execute DOS commands as they would be entered on  the 
  1650.         command  line.   If you can't do something from the  DOS  command 
  1651.         line, you can't do it from DM.  
  1652.  
  1653.         Some software programs are written with internal limitations that 
  1654.         make  them unsuitable for loading with data files  directly  from 
  1655.         DM.   DM can't make the function keys to do something  with  your 
  1656.         software  that  your  software  won't  do  in  the  first  place.  
  1657.         Remember the test:  If you can't do it from the DOS command line, 
  1658.         you can't do it from DM.
  1659.  
  1660.         The AutoRun Key 
  1661.  
  1662.         Just  like the programmable function keys, the AutoRun  (F2)  Key 
  1663.         also  has the capability of executing a program or a DOS  command 
  1664.         on a selected file in one keystroke.
  1665.  
  1666.         The AutoRun Key is different from the Programmable Function Keys, 
  1667.         in that you can use the same key to run any number of  programs, 
  1668.         or execute any number of DOS commands.  You only have to remember 
  1669.         one key.
  1670.  
  1671.         The  important  difference between the AutoRun (F2) Key  and  the 
  1672.         Programmable  Function Keys is that the AutoRun Key looks at  the 
  1673.         extension of the file at the pointer, and executes a DOS  command 
  1674.         that you have programmed to run on all files with that extension.  
  1675.  
  1676.         Suppose you program the AutoRun Key to run the BASIC program with 
  1677.         any  file  which  has a .BAS extension.  If  you  positioned  the 
  1678.         pointer next to a file named (for example) ALIENS.BAS and pressed 
  1679.         the  AutoRun  (F2) Key, the BASIC program will execute  with  the 
  1680.         ALIENS.BAS file loaded.
  1681.  
  1682.         The AutoRun Key won't automatically work for your software.   You 
  1683.         must  program this key yourself before it will work.  If the  key 
  1684.         isn't programmed, nothing will happen when you press it.
  1685.  
  1686.         Programming the AutoRun Key
  1687.  
  1688.         When  you  press the AutoRun Key, the computer will look  at  the 
  1689.         extension of the file next to the pointer and execute the command 
  1690.         you have designated for a file with that extension.
  1691.  
  1692.         The first step to custom programming the AutoRun Key is to make a 
  1693.         list  (on paper) of the extensions of files you want  to  execute 
  1694.         programs  on. Next, write a DOS command to correspond  with  each 
  1695.         extension. See examples later in this section.
  1696.  
  1697.  
  1698.         DM Users Manual                                          Page 31
  1699.         ________________________________________________________________
  1700.  
  1701.  
  1702.         You will need to use variables in the commands, like you did when 
  1703.         you programmed the Function Keys (see above).  The following  are 
  1704.         valid variables for DM.  
  1705.  
  1706.                   {F} = FileName             {P} = Path
  1707.                   {T} = Type in Text         {D} = Drive
  1708.                   {N} = Name no Ext          {E} = Ext no Name
  1709.                   {S} = Allow Program to Change Subdirectory
  1710.                   {A} = Press Any Key to Return to DM
  1711.  
  1712.         Suppose  you want to program your AutoRun (F2) key to run  BASIC, 
  1713.         loaded  with the file next to the pointer.  You may remember  the 
  1714.         command that we used in the example for the Programmable Function 
  1715.         Keys:
  1716.  
  1717.                      C:BASIC {F}    
  1718.  
  1719.         Since  the  AutoRun  Key looks only at the  extension,  you  will 
  1720.         program your commands a little differently than you did with  the 
  1721.         function keys.  Use the following format:
  1722.  
  1723.                      Extension=DOS command
  1724.                      
  1725.         So, the command for your BASIC program would be:
  1726.  
  1727.                      BAS=C:BASIC {F}    
  1728.  
  1729.         You may program the AutoRun (F2) Key to execute any DOS  command.  
  1730.         The command will be executed on the file at the pointer.
  1731.  
  1732.         Suppose  you have the WordStar word processor.  It  makes  backup 
  1733.         files with the extension .BAK, and you perhaps you don't want  to 
  1734.         to keep backup copies.  You could set up the command: 
  1735.  
  1736.                      BAK=DEL {F}
  1737.  
  1738.         If  you  positioned  the pointer at a file  named  LETTER.BAK  and 
  1739.         pressed (F2), LETTER.BAK would be deleted.
  1740.                  
  1741.         Suppose you set up the command COM={F}.  What would happen if you 
  1742.         placed  the pointer next to a file called PACKMAN.COM and  pressed 
  1743.         F2?  That's right, PACKMAN would run.
  1744.  
  1745.         Remember the test that you learned while programming the Function 
  1746.         Keys?  The rule is: If you can't do it from the DOS command line, 
  1747.         you  can't do it from DM.  Test your commands directly from  DOS, 
  1748.         so that you will be sure that they work.
  1749.  
  1750.         When you have tested all your commands, and have written them  in 
  1751.         the  "Extension=DOS command" format, you are ready to enter  them 
  1752.         into DM.  
  1753.  
  1754.  
  1755.         DM Users Manual                                          Page 32
  1756.         ________________________________________________________________
  1757.  
  1758.  
  1759.         For practice, let's enter the three examples given above.
  1760.  
  1761.                      BAS=BASIC {F}
  1762.                      BAK=DEL {F}
  1763.                      COM={F}
  1764.  
  1765.         Press the F8 (Edit Commands) key.  Pick option #4 "Change AutoRun 
  1766.         Commands."  The following will appear on the screen:
  1767.  
  1768.                 ====================================
  1769.                 |     Edit AutoRun Strings
  1770.                 |
  1771.                 |
  1772.                 |
  1773.                 |
  1774.  
  1775.         Type in the commands.  Use the arrow keys to move around the 
  1776.         screen and the backspace key to correct mistakes.
  1777.  
  1778.                 ====================================
  1779.                 |     Edit AutoRun Strings
  1780.                 | BAS=BASIC {F}
  1781.                 | BAK=DEL {F}
  1782.                 | COM={F}
  1783.                 |
  1784.  
  1785.         Press Esc when you are finished typing commands.  Test them  when 
  1786.         you  are finished.  If the commands do what you wanted,  you  are 
  1787.         ready to save the changes.  If you don't save them, they won't be 
  1788.         there  next time you use DM.  However, once they're  saved,  they 
  1789.         can't be accidentally changed until you "save" something new.  
  1790.  
  1791.         To  save your AutoRun commands, press F8, then choose option  "5" 
  1792.         (Save to DM.COM).  Your changes will be saved to disk.  
  1793.  
  1794.         FOR THE EXPERTS
  1795.  
  1796.         About Attributes
  1797.  
  1798.         An  attribute is a special characteristic assigned to a  file  by 
  1799.         the  computer  or the user.  If a file has any  attributes,  they 
  1800.         will be listed in the Status Window when the pointer is positioned 
  1801.         next to that file.  The following briefly explains the four types 
  1802.         of attributes.
  1803.  
  1804.         Hidden:  A "hidden" file will not be listed in the DOS directory. 
  1805.         (If  you  type the command "DIR" you won't see it.)  It  will  be 
  1806.         listed in the DM directory.  
  1807.  
  1808.         System:   This is a file that the computer uses internally.   You 
  1809.         should never mess with system files.  You do want your system  to 
  1810.         boot next time you turn it on, don't you?
  1811.  
  1812.  
  1813.         DM Users Manual                                          Page 33
  1814.         ________________________________________________________________
  1815.  
  1816.  
  1817.         Read Only:  A "read-only" file is write protected, which means it 
  1818.         can't  be changed.  It also can't be deleted under DOS.   But  it 
  1819.         can be deleted with DM.  You might want to change a file to "read 
  1820.         only" if you don't want anyone fooling with it.
  1821.  
  1822.         Archive:   When  you run the utility program which backs  up  the 
  1823.         hard disk, the program sets an "archive flag" on each file, which 
  1824.         tells  the  system that "this file has been backed up."   If  you 
  1825.         later modify that file, the archive flag is wiped out.  Then, the 
  1826.         next  time  the backup utility is run, it skips over  files  with 
  1827.         archive  flags,  because they've already been backed  up.   There 
  1828.         isn't any reason to change an archive attribute.  
  1829.  
  1830.         Changing Attributes
  1831.  
  1832.         Warning:  Do not use this unless you fully understand  attributes 
  1833.         and have a reason to change one.  
  1834.  
  1835.         To  change an attribute, place the pointer next to the file to  be 
  1836.         changed  and  press A (Change Attribute).  The  following  screen 
  1837.         will appear:
  1838.  
  1839.         Change File Attributes
  1840.                      
  1841.                      Hidden System Read-Only Archive
  1842.                      S to Set
  1843.                      R to Reset          |HSRA|
  1844.                      Space to Ignore     |_   |
  1845.  
  1846.         The letters in the brackets |HSRA| stand for: H = Hidden, S = 
  1847.         System, R = Read Only, and A = Archive
  1848.  
  1849.         You will type one of the codes shown on the screen below each of 
  1850.         the letters |HSRA|.  They mean:
  1851.  
  1852.         S to Set - An S sets that attribute to "on" for the file 
  1853.         indicated by the pointer. 
  1854.  
  1855.         R to Reset - R sets that attribute to "off" for the 
  1856.         indicated file.
  1857.  
  1858.         Space to Ignore - A space leaves the attribute as it is
  1859.  
  1860.              Example:    |HSRA| 
  1861.                          |S   | 
  1862.  
  1863.         This  would  set the hidden attribute for this file.   All  other 
  1864.         attributes  would remain as they were. If you want to change  the 
  1865.         attributes of a number of files at one time, mark (highlight) the 
  1866.         desired  files,  then press Alt A (Change Attributes  for  Marked 
  1867.         Files).   Set the attributes as described above.  The  attributes 
  1868.         you choose will be set for all marked files.
  1869.  
  1870.  
  1871.         DM Users Manual                                          Page 34
  1872.         ________________________________________________________________
  1873.  
  1874.  
  1875.         WORDSTAR COMPATIBILITY
  1876.  
  1877.         Some of the control characters used by the WordStar word  proces-
  1878.         sor  and other programs may be used in DM.  These characters  are 
  1879.         valid for scanning or marking files in a directory:
  1880.  
  1881.              Ctrl E - cursor up            Ctrl R - screen
  1882.              Ctrl X - cursor down          Ctrl C - screen down
  1883.              Ctrl D - mark file            Ctrl S - un-mark file
  1884.  
  1885.         The following characters are valid in the edit mode:
  1886.  
  1887.              Ctrl D - cursor left          Ctrl S - cursor right
  1888.              Ctrl G - erase character
  1889.  
  1890.         IMPROVING DM
  1891.  
  1892.         We value your comments and suggestions.  Your ideas will help  us 
  1893.         make  the next version of DM even better.  If you find a bug,  we 
  1894.         want  to know about it.  We offer registered users a "reward"  of 
  1895.         up to $75 for suggestions we use or bugs we fix.  
  1896.  
  1897.         DM USERS BULLETIN BOARD
  1898.  
  1899.         Computer  Tyme  has  set up a TBBS bulletin  board  dedicated  to 
  1900.         supporting  DM users.  The number is 417-866-1665, and it's  open 
  1901.         24  hours a day.  You will need a 1200, or 2400 baud  modem,  and 
  1902.         terminal software to support ANSI graphics.  
  1903.  
  1904.  
  1905.         Other Programs                                           Page 35
  1906.         ________________________________________________________________
  1907.  
  1908.  
  1909.         "D" is a "sweet little directory program."  It provides a  sorted 
  1910.         multi-column directory listing which makes reading the  directory 
  1911.         a pleasure. Just type "D" to execute.  For all user levels. 
  1912.  
  1913.         Usage: D <path\mask> /E/D/S/U/B/N/F/I/R/A/L/W/O/P
  1914.  
  1915.         /E Sort by Ext                   /D Sort by Date
  1916.         /S Sort by Size                  /U Unsorted
  1917.         /B Sort Backwards                /N Show File Names Only
  1918.         /F Full Display, Date & Time     /I Identify Directory
  1919.         /R Programs that can Run         /A Files with Archive Set
  1920.         /L Long Display, no Pause        /W Wait for Keypress at End
  1921.         /O Use Standard Output Device    /P Output to Printer
  1922.  
  1923.         Default options can be set using the Environment Strings.
  1924.         SET D.EXE=/O/I selects Standard Output and Identify Directory.
  1925.         -----------------------------------------------------------------
  1926.  
  1927.         "T"  also  called "PickDir" allows you to change  directories  as 
  1928.         quickly as possible.   Just type "T". For all user levels.
  1929.         Lower case letter selects directory.
  1930.         Upper case letter selects directory and exits.
  1931.         Ctrl letter to change drives.
  1932.  
  1933.         - Previous Directory
  1934.         \ Root Directory
  1935.         <CR> Exit
  1936.         -----------------------------------------------------------------
  1937.  
  1938.         MOVE  moves  files  to other  names,  subdirectories  or  drives.  
  1939.         Options  include  the  quiet mode  (no  message  displayed  while 
  1940.         moving),  moving read-only, hidden and system files. Type  "Move" 
  1941.         to  execute.  For all user levels. Moves files  to  other  names, 
  1942.         subdirectories or drives.
  1943.  
  1944.         Usage: MOVE <file> <path> /Q/O/R/H   WildCards are Allowed.
  1945.  
  1946.           /Q  ;Quiet Mode, no Messages are Displayed while Moving.
  1947.           /O  ;OverWrite Existing Files.
  1948.           /R  ;Include Read-Only Files.
  1949.           /H  ;Include Hidden, System, and Read-Only Files.
  1950.  
  1951.         The command SET MOVE=OVERWRITE will make MOVE default to overwrite mode.
  1952.  
  1953.           MOVE XYZ.DOC \SUBDIR        ;Moves XYZ.DOC to subdirectory SUBDIR
  1954.           MOVE XYZ.DOC D:             ;Moves XYZ.DOC to D:
  1955.           MOVE *.DOC \SUBDIR          ;Moves all .DOC files to SUBDIR
  1956.           MOVE ABC.DOC XYZ.DOC        ;Renames ABC.DOC to XYZ.DOC
  1957.           MOVE *.DOC \SUBDIR\*.TXT    ;Moves all .DOC files to SUBDIR and
  1958.                                        changes names to .TXT
  1959.  
  1960.         Pipes  and  redirection  are also  allowed:
  1961.  
  1962.         TYPE MOVE.LST|MOVE  C:\UTIL;  Moves all  files  in  MOVE.LST  to C:\UTIL
  1963.  
  1964.  
  1965.         Other Programs                                           Page 36
  1966.         ________________________________________________________________
  1967.  
  1968.  
  1969.  
  1970.         SORT  is just like MS-DOS sort except that it is only limited  by 
  1971.         memory size instead of 64k, and it is 100 times faster. Sort also 
  1972.         has  a  /I option to ignore case and will  accept  optional  file 
  1973.         names on the command line for input and output.
  1974.         Usage SORT <file> <file> /R/I/+N
  1975.  
  1976.         Optional filenames for input and output files.
  1977.           /R    Reverse Sort.
  1978.           /+N   Start sorting with column N.
  1979.           /I    Ignore Case.
  1980.  
  1981.  
  1982.         ----------------------------------------------------------------
  1983.  
  1984.  
  1985.         MORE is just like MS-DOS more except a lot slicker. It erases 
  1986.         its prompts and gives you a pause at the end of the text  stream. 
  1987.         Pressing the space bar advances a page at a time and pressing the 
  1988.         return key advances a line at a time. 
  1989.  
  1990.         Usage: DIR|SORT|MORE or TYPE DOLIST.DOC|MORE
  1991.  
  1992.  
  1993.         -----------------------------------------------------------------
  1994.  
  1995.  
  1996.         FIND is just like MS-DOS find with the following additions:
  1997.  
  1998.         Usage: FIND "String" <File File File> /V/C/N/L/P/I
  1999.  
  2000.           /V Displays all lines that do not contain String.
  2001.           /C Counts lines that contain String.
  2002.           /N Adds line numbers to output.
  2003.           /L List only names of files that contain String.
  2004.           /P Pauses display every 24 lines.
  2005.           /I Ignore Case.
  2006.         <file> may include wildcards.
  2007.  
  2008.  
  2009.         -----------------------------------------------------------------
  2010.  
  2011.  
  2012.         FREE is a simple program that swows you how many bytes are on the 
  2013.         disk,  how  many are free, and how many are used. It  also  shows 
  2014.         total  memory  and  memory used. It does  not  show  extended  or 
  2015.         expanded memory so if you have more than 640k, this program won't 
  2016.         show it. The sector size and the cluster size are also displayed.
  2017.  
  2018.         Usage FREE or FREE <drive>
  2019.  
  2020.  
  2021.  
  2022.         Other Programs                                           Page 37
  2023.         ________________________________________________________________
  2024.  
  2025.  
  2026.         WHEREIS  is  just like PIPEDIR except the root directory  and  /S 
  2027.         options are always selected. Output from Whereis is suitable  for 
  2028.         piping filenames into other applications. 
  2029.  
  2030.         Usage: Whereis <Path\Mask> /H/T/P/A/F/D/Q
  2031.  
  2032.           /H include hidden and system files.
  2033.           /T gives only directory names.
  2034.           /P same as /T but adds a \ to the end.
  2035.           /A files that have been modified since last backup.
  2036.           /F file names only, no path.
  2037.           /D deletes files.
  2038.           /Q ask before delete.
  2039.  
  2040.         Examples:
  2041.  
  2042.         Whereis *.BAK          ;Prints all *.BAK files on disk.
  2043.         Whereis *.BAK /D       ;Deletes all *.BAK files on disk.
  2044.         Whereis /T             ;Prints all subdirectory names.
  2045.         Whereis *.* /A         ;Prints files changed since last backup.
  2046.         Whereis *.* >ALL.TXT   ;Prints all files on disk to ALL.TXT.
  2047.  
  2048.         -----------------------------------------------------------------
  2049.  
  2050.         PIPEDIR is a utility that lists the directory in a way  that  is 
  2051.         suitable  for  piping  and redirection and  usable  with  DoList. 
  2052.         Output  from PipeDir is suitable for piping filenames into  other 
  2053.         applications.
  2054.  
  2055.         Usage: PipeDir <Path\Mask> /S/H/T/P/A/F/D/R/Q
  2056.  
  2057.           /S includes all subdirectories below Path.
  2058.           /H include hidden and system files.
  2059.           /T gives only directory names.
  2060.           /P same as /T but adds a \ to the end.
  2061.           /A files that have been modified since last backup.
  2062.           /F file names only, no path.
  2063.           /D deletes files.
  2064.           /R remove directory, all files, and all subdirectories.
  2065.           /Q ask before delete.
  2066.  
  2067.         Examples:
  2068.  
  2069.         PipeDir \*.BAK /S      ;Prints all *.BAK files on disk.
  2070.         PipeDir \*.BAK /S/D    ;Deletes all *.BAK files on disk.
  2071.         PipeDir \ /T           ;Prints all subdirectory names.
  2072.         PipeDir \*.* /S/A      ;Prints files changed since last backup.
  2073.         PipeDir \ /S >ALL.TXT  ;Prints all files on disk to ALL.TXT.
  2074.         PipeDir C:\JUNK /R     ;Removes directory JUNK and all files it contains.
  2075.  
  2076.  
  2077.         Other Programs                                           Page 38
  2078.         ________________________________________________________________
  2079.  
  2080.  
  2081.         FORK  This  program  is used in DOS  piping  commands  to  either 
  2082.         display  what  is going through the pipe or to  capture  what  is 
  2083.         going  through the pipe to a file.  Text going through  the  pipe 
  2084.         may be You may redirect piped files to the screen or another file 
  2085.         without interfering with the piping process.
  2086.  
  2087.         DIR|FORK  >X will do the same thing as DIR >X except you will  be 
  2088.         able to SEE the text.
  2089.  
  2090.         DIR|FORK Y >X will do the same thing as DIR >X except that output 
  2091.         is also directed to file Y.
  2092.  
  2093.         DIR|FORK|SORT  will  show the directory first unsorted  and  then 
  2094.         sorted.
  2095.  
  2096.         If the first character after FORK is a / then the text after  the 
  2097.         / is interpreted as a secondary command line to be executed  with 
  2098.         the text coming into the pipe fed into the secondary command.
  2099.  
  2100.         DIR|FORK /MORE|SORT|MORE will show the directory unsorted with  a 
  2101.         pause every 24 lines, then sorted with a pause every 24 lines.
  2102.  
  2103.         Since  MS-DOS filters out redirection and piping  commands,  FORK 
  2104.         interprets  the secondary command line. @] is translated into  >, 
  2105.         @]] is translated into >>, and @! is translated into |.
  2106.  
  2107.         DIR|FORK  /FIND  "  COM "@]  COM.LST|FIND  "BAT"  >BAT.LST.  This 
  2108.         command  will make a list of all the *.COM files in COM.LST,  and 
  2109.         all the *.BAT files in BAT.LST.
  2110.  
  2111.         -----------------------------------------------------------------
  2112.  
  2113.         PATCH  designed for the advanced user, allows you to patch  files 
  2114.         in either ASCII or HEX.  Cursor movement supports a Wordstar  key 
  2115.         pattern  as  well  as responding to  cursor  control  keys.  Type 
  2116.         "PATCH".
  2117.  
  2118.         Usage: PATCH <FileName>
  2119.  
  2120.         Left Arrow  * ^S = Character Left
  2121.         Right Arrow * ^D = Character Right
  2122.         Up Arrow    * ^E = Character Up
  2123.         Down Arrow  * ^X = Character Left
  2124.  
  2125.         Ctrl Left Arrow  * ^Q^S = Left Side of Window
  2126.         Ctrl Right Arrow * ^Q^D = Right Side of Window
  2127.         Ctrl Up Arrow    * ^Q^E = Top Side of Window
  2128.         Ctrl Down Arrow  * ^Q^X = Bottom Side of Window
  2129.  
  2130.         Home * ^W = Upper Left Corner        PgUp * ^R = Sector Backwards
  2131.         End  * ^Z = Lower Right Corner       PgDn * ^C = Sector Forward
  2132.  
  2133.         Ctrl Home * ^Q^R = Beginning of file
  2134.         Ctrl End  * ^Q^C = End of File
  2135.  
  2136.  
  2137.         Other Programs                                           Page 39
  2138.         ________________________________________________________________
  2139.  
  2140.  
  2141.         DOLIST
  2142.  
  2143.         About DoList
  2144.  
  2145.         DoList  is  a  dual  purpose program. It acts  as  a  DOS  SHELL, 
  2146.         allowing  the  easy and convenient entry of commands, and  it  is 
  2147.         capable of executing commands on a LIST of files.
  2148.  
  2149.         DoList in the SHELL mode:
  2150.  
  2151.         DOLIST @S <cmd>
  2152.  
  2153.         DoList  has the ability to act like a DOS SHELL.  Whenever  input 
  2154.         redirection is not specified, input comes from the standard input 
  2155.         device. DoList detects this and uses it's powerful line editor to 
  2156.         provide input lines.
  2157.  
  2158.         To  use  DoList  in the shell mode type DOLIST  @S.  DoList  will 
  2159.         confirm keyboard input with the message:
  2160.  
  2161.         Shell Mode Enabled * Type "EXIT" to Return to DOS.
  2162.  
  2163.         Shell  mode  allows you to type command lines  with  the  editing 
  2164.         power of a word processor. It stores the commands you execute  so 
  2165.         that  you can recall them and re-execute them. And  it  remembers 
  2166.         the  subdirectories that you've moved to, allowing you to  easily 
  2167.         return.
  2168.  
  2169.         During shell mode, all normal word processor editing keys, (Home, 
  2170.         End, Arrows), work to edit the command line. The UP arrow recalls 
  2171.         the previous commands you've executed and the DOWN arrow reverses 
  2172.         this  process.  The  Escape key aborts command  line  entry.  The 
  2173.         WORDSTAR command set is also supported.
  2174.  
  2175.         Using  DOLIST @S, DoList inputs commands from it's powerful  line 
  2176.         editor and executes COMMAND /C <line> as a subtask. Due to  this, 
  2177.         you lose about 23k of ram.
  2178.  
  2179.         Enhancements:
  2180.  
  2181.         Upon  entering  the SHELL mode, DoList displays its  own  prompt. 
  2182.         This  prompt  shows  both the drive and path.  Using  the  prompt 
  2183.         command will not change this.
  2184.  
  2185.         Typing \ changes you to the root directory. Typing - changes  you 
  2186.         to the previous directory. Typing a directory name allows you  to 
  2187.         change to that directory without typing CD.
  2188.  
  2189.         DoList  remembers the subdirectories you've been to. By  pressing 
  2190.         the  TAB  key, DoList will rotate you through  the  last  several 
  2191.         directories  you've  been to. This allows you to  switch  between 
  2192.         directories quickly and easily.
  2193.  
  2194.  
  2195.  
  2196.         Other Programs                                           Page 40
  2197.         ________________________________________________________________
  2198.  
  2199.  
  2200.         Dolist will execute BASIC programs without having to type  BASIC. 
  2201.         DoList recognizes the .BAS extention and loads BASIC for you.  In 
  2202.         order  to  use  this  feature, you must  tell  DoList  where  the 
  2203.         BASIC.EXE file is using the SET command.
  2204.  
  2205.         Example: SET BASIC=C:\BASIC.EXE
  2206.  
  2207.         When  using  DOLIST @S in a .BAT file, if you want  execution  to 
  2208.         continue after loading DOLIST, type DOLIST @S <cmd>. Where  <cmd> 
  2209.         is any dos command you want to execute.
  2210.  
  2211.         DoList in Command Mode
  2212.  
  2213.         Did you ever want to execute a program on a LIST of files? That's 
  2214.         what  DoList  does.  DoList  will  execute  a  command  line  and 
  2215.         substitute text from the standard input device in the command line.
  2216.  
  2217.         Suppose you had a file named BAK.LST that contained the  following 
  2218.         list of files:
  2219.  
  2220.         NOTES.BAK
  2221.         JOBS.BAK
  2222.         AUTOEXEC.BAK
  2223.  
  2224.         If you want to delete all the files in the list you type:
  2225.  
  2226.         DOLIST DEL @L < BAK.LST or
  2227.         TYPE BAK.LST|DOLIST DEL @L
  2228.  
  2229.         DoList will then execute the following commands:
  2230.  
  2231.         DEL NOTES.BAK
  2232.         DEL JOBS.BAK
  2233.         DEL AUTOEXEC.BAK
  2234.  
  2235.         DoList reads each line from the standard input device and executes
  2236.         the command for each line read. The @L causes DoList to insert the
  2237.         next input line into the command.
  2238.  
  2239.         Suppose we wanted to copy all the *.BAT files to drive A:.
  2240.         We would type:
  2241.  
  2242.         PIPEDIR \*.BAT /S|DOLIST COPY @L A:
  2243.  
  2244.         Or  if we wanted to create an ARC file of all the *.BAT files  we 
  2245.         would type.
  2246.  
  2247.         PIPEDIR \*.BAT /S|DOLIST ARC A BAT.ARC @L
  2248.  
  2249.         In  addition to the @L command which substitutes the whole  line, 
  2250.         DOLIST  can look at the lines as fields that can  be  substituted 
  2251.         individually.  The individual fields are substituted by  @1  thru 
  2252.         @9.
  2253.  
  2254.  
  2255.  
  2256.         Other Programs                                           Page 41
  2257.         ________________________________________________________________
  2258.  
  2259.  
  2260.         In the text line:
  2261.  
  2262.         456,NOTES.TXT "Marc Perkel"
  2263.  
  2264.         @1 = 456
  2265.         @2 = NOTES.TXT
  2266.         @3 = Marc Perkel
  2267.  
  2268.         The rule is that commas and spaces are delimiters unless you start
  2269.         with  a quote. If you start with a quote, the next quote  is  the 
  2270.         delimiter.
  2271.  
  2272.         If you don't want DoList to actually execute the commands, the @T
  2273.         command will cause DoList to output the text that it would have
  2274.         executed.  This  text  can  be redirected to  a  file  for  later 
  2275.         execution.
  2276.  
  2277.         The  @Q  command makes DoList ask before executing  each  command 
  2278.         line. This allows you to skip the command or abort DoList. The @S 
  2279.         command  puts DoList in the SHELL mode. This creates  a  friendly 
  2280.         enhanced dos-like user interface.
  2281.  
  2282.         Two commands @I<filename> and @O<filename> can be used to choose
  2283.         the input and output files for DoList. This can be used in  place 
  2284.         of  the pipes and redirection for dos. You must have at  least  1 
  2285.         space after the filenames.
  2286.  
  2287.         Example:
  2288.         PIPEDIR  *.BAT >BAT.LST ; creates BAT.LST with list of all  *.BAT 
  2289.         files.
  2290.  
  2291.         DOLIST  COPY  @IBAT.LST @L@T A: @OTEST.BAT ;reads  each  line  of 
  2292.         BAT.LST  and creates the command COPY <line> A: and writes  these 
  2293.         commands to a file named TEST.BAT.
  2294.  
  2295.         Using braces '{}' suspends interpretation of @ commands  allowing 
  2296.         the @ to be part of the command. The outermost pair of braces are 
  2297.         removed  from  the  command. This is  useful  when  using  DoList 
  2298.         recursively. That means using DoList to run DoList.
  2299.  
  2300.         When  a  command line is presented to DOS,  the  redirection  and 
  2301.         piping  commands, < > | are interpreted and removed. In order  to 
  2302.         pass these commands to a program that DoList can run, we must use 
  2303.         other  codes that dos won't remove. The @[ is translated into  <, 
  2304.         the  @] is translated into >, the @]] is translated into  >>  and 
  2305.         the @! is translated into |.
  2306.  
  2307.  
  2308.         Other Programs                                           Page 42
  2309.         ________________________________________________________________
  2310.  
  2311.  
  2312.         Using DoList Recursively:
  2313.  
  2314.  
  2315.         Lets say we have a file named X.LST that contains the lines:
  2316.         1
  2317.         2
  2318.         3
  2319.  
  2320.         And a file named Y.LST that contains the lines:
  2321.         A
  2322.         B
  2323.         C
  2324.  
  2325.         The following command produces the following results:
  2326.  
  2327.         DOLIST {DOLIST @L@T@Ix.lst }@L <y.lst
  2328.  
  2329.         A1
  2330.         A2
  2331.         A3
  2332.         B1
  2333.         B2
  2334.         B3
  2335.         C1
  2336.         C2
  2337.         C3
  2338.  
  2339.         This type of processing opens some interesting possibilities.
  2340.  
  2341.         Inside DoList:
  2342.  
  2343.         DoList  loads  COMMAND.COM  /C <commandline>  for  each  line  it 
  2344.         executes.  This  allows DoList to run multiple execution  of  BAT 
  2345.         files  as well as COM and EXE files. DoList stays resident  while 
  2346.         executing  so  you lose about 23k of ram until  it  finishes.  If 
  2347.         output is redirected to a file, then all child processes are also 
  2348.         redirected.
  2349.  
  2350.         You can make DoList run faster if you have a RamDisk by copying
  2351.         COMMAND.COM to your RamDisk and using the SET COMSPEC= command to
  2352.         point  to  the ramdisk. This must be done before going  into  the 
  2353.         SHELL mode.
  2354.  
  2355.         If  you  are not sure what a DoList command will do, use  the  @T 
  2356.         option to produce text instead of executing. If the commands  are 
  2357.         right, then use it without the @T.
  2358.  
  2359.  
  2360.         Other Programs                                           Page 43
  2361.         ________________________________________________________________
  2362.  
  2363.  
  2364.  
  2365.         Summary of DoList Commands:
  2366.  
  2367.         @L          ;substitute next input line
  2368.         @1 .. @9    ;substitute field 1 thru 9
  2369.         @T          ;output commands as text instead of executing them
  2370.         @S          ;puts DOLIST in SHELL mode
  2371.         @Q          ;query mode, displays command and asks for conformation
  2372.         @I<filename>;use <filename> for input file for DOLIST
  2373.         @O<filename>;use <filename> for output file for DOLIST
  2374.         @[          ;substitutes < in command line
  2375.         @]          ;substitutes > in command line
  2376.         @]]         ;substitutes >> in command line
  2377.         @!          ;substitutes | in command line
  2378.         {}          ;commands in {braces} are not interpreted but  passed
  2379.                      as text
  2380.  
  2381.         Before doing the following examples you will need to  familiarize 
  2382.         yourself  with the Computer Tyme Software Programs  described  on 
  2383.         pages 7-9 of this manual.
  2384.  
  2385.         Fun with DOLIST:
  2386.  
  2387.         Some of these examples assume that the reader knows the commands
  2388.         ARC  and PKARC. These programs are used mostly by people who  use 
  2389.         modems  and transfer files by phone to bulletin board  computers. 
  2390.         You don't have to know about these programs to use DoList. If you 
  2391.         don't  own  a  modem, you are missing out on  a  whole  level  of 
  2392.         computer  enjoyment  and you should go to your  nearest  computer 
  2393.         store and buy one.
  2394.  
  2395.         Try these examples:
  2396.  
  2397.         PIPEDIR \*.BAK /S|DOLIST DEL @L     ;
  2398.         (deletes all BAK files in all directories.)
  2399.         DIR|FIND " BAK "|DOLIST DEL @1.@2   ;
  2400.         (deletes BAK files in current directory.)
  2401.  
  2402.         Create a file called TRASH.LST that contains extensions that need 
  2403.         to be deleted from your hard disk.
  2404.         Example:
  2405.         BAK
  2406.         BWS
  2407.         TMP
  2408.         IFF
  2409.         BDC
  2410.         BTX
  2411.         BP?
  2412.  
  2413.  
  2414.         Other Programs                                           Page 44
  2415.         ________________________________________________________________
  2416.  
  2417.  
  2418.         Then you can get rid of these files by typing:
  2419.  
  2420.         DOLIST WHEREIS *.@L|DOLIST DEL @L <TRASH.LST or
  2421.         TYPE TRASH.LST|DOLIST WHEREIS *.@L|DOLIST DEL @L
  2422.  
  2423.         Did  you ever accidently copy a floppy disk onto your  hard  disk 
  2424.         and get the files in your root directory instead of the directory 
  2425.         that they were supposed to go into? When that happens you've  got 
  2426.         to go in and figure out what files to delete. PIPEDIR and  DOLIST 
  2427.         can fix your problem.
  2428.  
  2429.         PIPEDIR A:*.*/F|DOLIST DEL @L
  2430.  
  2431.         The list of files on A: is used for the list to delete the  files 
  2432.         on C:.
  2433.  
  2434.         Suppose  you want to ARC all files that have been  changed  since 
  2435.         the last backup. You could type:
  2436.  
  2437.         PIPEDIR  \ /S/A|DOLIST PKARC A BACKFILE.ARC @L - This will  cause 
  2438.         all modified files to be ARC'ed into BACKFILE.ARC.
  2439.  
  2440.         Suppose you want to test the integrity of all your ARC files. You
  2441.         could type:
  2442.  
  2443.         WHEREIS *.ARC|DOLIST PKXARC -T @L >ERROR.LOG
  2444.  
  2445.         This will run a test on all ARC files on the disk with output to
  2446.         a file called ERROR.LOG. This file can then be printed.
  2447.  
  2448.         Now  suppose  after  you have tested the integrity  of  your  arc 
  2449.         files,  you want to make a list of all files in the ARC and  sort 
  2450.         them, you type:
  2451.  
  2452.         TYPE ERROR.LOG|FIND "Testing"|DOLIST @2@T|SORT >SORTLIST or  from 
  2453.         the beginning
  2454.  
  2455.         WHEREIS *.ARC|DOLIST PKXARC -T @L|FIND "Testing"|DOLIST @2@T|SORT 
  2456.         >SORTLIST which makes for quite a pipe.
  2457.  
  2458.         Suppose  you  have a lot of ARC files on your hard disk  and  you 
  2459.         want to Re-Arc them with PKARC. Here's what you do:
  2460.  
  2461.         Create a \TEMP directory in the root. (MD \TEMP)
  2462.         Create  a  BAT file called UPDATE.BAT  containing  the  following 
  2463.         commands:
  2464.  
  2465.         pkxarc %1 \temp
  2466.         del %1
  2467.         pkarc a %1 \temp\*.*
  2468.         echo Y|del \temp\*.*
  2469.         Test  this bat file by typing UPDATE <file.arc> to make  sure  it 
  2470.         works. Then, to do the whole disk, type:
  2471.         PIPEDIR \*.ARC /S|DOLIST UPDATE @L
  2472.  
  2473.  
  2474.         Other Programs                                           Page 45
  2475.         ________________________________________________________________
  2476.  
  2477.  
  2478.         TESTIF
  2479.  
  2480.         TESTIF  tests the system and returns DOS error codes that can  be 
  2481.         used  to control the execution of .BAT files.  Error codes  range 
  2482.         from  0  to 255.  Within this program are  commands  for  reading 
  2483.         system parameters and processing them mathematically into  useful 
  2484.         error  codes. VideoMode, a Testif command, will for  example,  if 
  2485.         you have both mono and color screens on your computer, bring up a 
  2486.         piece  of  software  on  the  desired  screen  by  executing  the 
  2487.         appropriate .BAT file.  Type "TESTIF". For the intermediate user.
  2488.  
  2489.           REM This checks to see if selected screen is MONO or COLOR
  2490.           TESTIF VideoMode
  2491.           IF ERRORLEVEL 7 GOTO MONO
  2492.           :COLOR
  2493.              ....
  2494.              ....
  2495.              GOTO END
  2496.           :MONO
  2497.              ....
  2498.              ....
  2499.           :END
  2500.  
  2501.         VideoMode  is  a Testif command that returns  the  current  video 
  2502.         mode. If the current mode is MONO then VideoMode returns a 7.
  2503.  
  2504.         With  this  command, if you have both MONO and COLOR  screens  on 
  2505.         your  computer, and you want to set up a .BAT file to bring up  a 
  2506.         piece of software that is installed different for mono and COLOR, 
  2507.         Testif makes it easy.
  2508.  
  2509.         Testif  has  the capibility to test results to see if  a  command 
  2510.         equals a value.
  2511.  
  2512.           TESTIF VideoMode = 7
  2513.  
  2514.         Returns  error  code 1 if true and 0 if not true. A 1  is  always 
  2515.         returned  to indicate TRUE and 0 is returned to  indicate  FALSE. 
  2516.         Operators  include =, [], [, ], [=, ]=. Note the square  brackets 
  2517.         replace  the normal greater than and less than symbols.  That  is 
  2518.         because  MS-DOS filters these characters and therefore  can't  be 
  2519.         used.
  2520.  
  2521.           TESTIF Year = 88 and Month = May
  2522.  
  2523.         Testif supports all logical operators such as AND, OR, XOR,  NOT. 
  2524.         Multiple  conditions can be used. Year returns the year  part  of 
  2525.         the system date. Month returns the month part. May is a  constant 
  2526.         equal  to  5. The error code result will be 1 for true or  0  for 
  2527.         false.
  2528.  
  2529.           TESTIF MemSize / 10
  2530.  
  2531.  
  2532.         Other Programs                                           Page 46
  2533.         ________________________________________________________________
  2534.  
  2535.  
  2536.         MemSize returns the total memory size in K. Since this number  is 
  2537.         usually  larger than 255, (the maximum error code), we devide  by 
  2538.         10.  On  a  640k  machine, the return code  is  64.  Notice  that 
  2539.         division is supported. Testif supports the mathematical operators 
  2540.         +, -, *, /, MOD, SHL, SHR, AND, OR, XOR.
  2541.  
  2542.         All numbers are processed as signed 32 bit integers. It is up  to 
  2543.         you to keep the result between 0 and 255 for meaningful results.
  2544.  
  2545.           TESTIF 5*(9+3)
  2546.  
  2547.         Interpretation is from left to right. Parentheses can be used  to 
  2548.         alter this order. The above example returns 60.
  2549.  
  2550.           TESTIF FreeSpace(0) ] 4000000
  2551.  
  2552.         This checks freespace on the current drive (0). Other drives  can 
  2553.         also be checked. The result is 1 if more than 4,000,000 bytes are 
  2554.         free.
  2555.  
  2556.           TESTIF FileSize TESTIF.EXE / 1024
  2557.  
  2558.         This returns the filesize of TESTIF.EXE in K.
  2559.  
  2560.         To test your formulas, start the line with an @ sign. Testif will 
  2561.         print the return code on the screen.
  2562.  
  2563.            TESTIF @DosVersion
  2564.            ErrorLevel: 3
  2565.  
  2566.         TESTIF Commands:
  2567.  
  2568.         Day of Week
  2569.         SUN  ErrorLevel = 0
  2570.         MON  ErrorLevel = 1
  2571.         TUE  ErrorLevel = 2
  2572.         WED  ErrorLevel = 3
  2573.         THU  ErrorLevel = 4
  2574.         FRI  ErrorLevel = 5
  2575.         SAT  ErrorLevel = 6
  2576.  
  2577.         Month
  2578.         JAN  ErrorLevel = 1
  2579.         FEB  ErrorLevel = 2
  2580.         MAR  ErrorLevel = 3
  2581.         APR  ErrorLevel = 4
  2582.         MAY  ErrorLevel = 5
  2583.         JUN  ErrorLevel = 6
  2584.         JUL  ErrorLevel = 7
  2585.         AUG  ErrorLevel = 8
  2586.         SEP  ErrorLevel = 9
  2587.  
  2588.  
  2589.         Other Programs                                           Page 47
  2590.         ________________________________________________________________
  2591.  
  2592.  
  2593.         TESTIF Commands, cont.
  2594.  
  2595.         OCT  ErrorLevel = 10
  2596.         NOV  ErrorLevel = 11
  2597.         DEC  ErrorLevel = 12
  2598.  
  2599.         MONO ErrorLevel = 7
  2600.         CO80 ErrorLevel = 3
  2601.         BW80 ErrorLevel = 2
  2602.         CO40 ErrorLevel = 1
  2603.         BW40 ErrorLevel = 0
  2604.  
  2605.         VideoMode             Returns Current Video Mode
  2606.         VideoPage             Returns Current Video Page
  2607.         ScreenWidth           Returns Current Screen Width
  2608.         Year                  Returns System Year            (88=1988)
  2609.         Month                 Returns System Month           (1=Jan)
  2610.         Day                   Returns System Day             (01-31)
  2611.         DayOfWeek             Returns System Day of Week (0=SUN,2=MON,etc)
  2612.         Hour                  Returns System Hour
  2613.         Minute                Returns System Minute
  2614.         Second                Returns System Second
  2615.         WriteVerify           Returns if Write Verify is on
  2616.         DosVersion            Returns Dos Version Number
  2617.         MinorDosVersion       Returns Minor Dos Version Number
  2618.         CurrentDrive          Returns Current Drive Number   (A: = 0)
  2619.         Drives                Returns Number of Drives
  2620.         Floppies              Returns Number of Floppy Drives
  2621.         SerialPorts           Returns Number of Serial Ports
  2622.         ParallelPorts         Returns Number of Parallel Ports
  2623.         CapsLock              Tells if Caps Lock is on       (1=True)
  2624.         NumLock               Tells if Num Lock is on        (0=False)
  2625.         ScrollLock            Tells if Scroll Lock is on
  2626.         MemSize               Returns Total Memory Size in K
  2627.         Random                Returns a Random Number from 0 to 255.
  2628.         SectorsPerCluster(n)  Returns Number of Sectors per Cluster  (0=Current Drive)
  2629.         BytesPerSector(n)     Returns Number of Bytes per Sector     (1=A:)
  2630.         FreeClusters(n)       Returns Number of Free Clusters        (2=B:)
  2631.         TotalClusters(n)      Returns Total Number of Clusters       (3=C:)
  2632.         FreeSpace(n)          Returns Free Space in Bytes            (4=D:)
  2633.         TotalSpace(n)         Returns Total Space in Bytes
  2634.         Exist <FileName>      Tells if File Exists
  2635.         FileSize <FileName>   Returns File Size in Bytes
  2636.         FileAttr <FileName>   Returns File Attribute
  2637.         FileDate <FileName>   Returns Date and Time as 32 bit Number
  2638.         Mem(A:B)              Returns Byte at A:B
  2639.         MemW(A:B)             Returns Word at A:B
  2640.         Port(A)               Returns Byte at Port A
  2641.  
  2642.         =     True if A = B
  2643.         []    True if A <> B (not equal)
  2644.  
  2645.  
  2646.         Other Programs                                           Page 48
  2647.         ________________________________________________________________
  2648.  
  2649.  
  2650.         [     True if A < B
  2651.         ]     True if A > B
  2652.         [=    True if A <= B
  2653.         ]=    True if A >= B
  2654.         +     Returns A + B
  2655.         -     Returns A - B
  2656.         *     Returns A * B
  2657.         /     Returns A / B
  2658.         MOD   Returns A mod B
  2659.         AND   Returns A and B
  2660.         OR    Returns A or B
  2661.         XOR   Returns A xor B
  2662.         SHL   Returns A shl B  (Shift Left)
  2663.         SHR   Returns A shr B  (Shift Right)
  2664.         NOT   Returns not A
  2665.  
  2666.         I am going to expand this program. I welcome suggestions. If  you 
  2667.         want me to include a test that this program doesn't have, let me 
  2668.         know how the test is performed. (DOS call, memory location, port, 
  2669.         etc.)
  2670.                                                      Marc Perkel
  2671.  
  2672.  
  2673.                                  COMPUTER TYME, INC.
  2674.                                   216 S. GLENSTONE
  2675.                                 SPRINGFIELD, MO 65802
  2676.                                    (417) 866-1222
  2677.  
  2678.